[gedit] docs: gedit-development-getting-started: some improvements
- From: Sébastien Wilmet <swilmet src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gedit] docs: gedit-development-getting-started: some improvements
- Date: Tue, 14 Apr 2020 18:05:35 +0000 (UTC)
commit 641ccd131dce4c0e43aebb76e0a1a89f490f7670
Author: Sébastien Wilmet <swilmet gnome org>
Date: Tue Apr 14 20:03:38 2020 +0200
docs: gedit-development-getting-started: some improvements
docs/gedit-development-getting-started.md | 14 ++++++++++----
1 file changed, 10 insertions(+), 4 deletions(-)
---
diff --git a/docs/gedit-development-getting-started.md b/docs/gedit-development-getting-started.md
index 6b64bded2..1cd3775ae 100644
--- a/docs/gedit-development-getting-started.md
+++ b/docs/gedit-development-getting-started.md
@@ -69,16 +69,15 @@ First contribution
------------------
See the [Newcomers](https://wiki.gnome.org/Newcomers/) page to start
-contributing to GNOME in general.
+contributing to GNOME in general. But perhaps some things explained there are
+not relevant for gedit, in case of doubt the gedit documentation takes
+precedence.
To know how to contribute to gedit specifically, read the
[README.md](../README.md) and [CONTRIBUTING.md](../CONTRIBUTING.md) files
present in the Git repository (and then you'll see that the `CONTRIBUTING.md`
file refers to this file, but please don't end up in an infinite reading loop).
-To find something interesting to do, […]. TODO: provide list of easy tasks in
-gedit itself.
-
A good way to learn a lot of things is to write a new plugin (as a third-party
plugin first). To have some inspiration, see the wiki page
[RequestedPlugins](https://wiki.gnome.org/Apps/Gedit/RequestedPlugins).
@@ -90,6 +89,13 @@ or critical message, it is also a good idea to fix it.
Improvements to the documentation (for users or developers) or the wiki is also
useful.
+Note that gedit, although simple to use, is old. Some parts of the code is
+legacy code. The remaining tasks to do are often not simple, the codebase needs
+a lot of refactoring, and to do it properly an experienced developer is advised.
+That's why writing plugins is normally easier; except that there is not a lot of
+documentation for plugin authors (another thing that needs to be improved over
+time).
+
Interesting article to read, written by a GNOME developer:
[Working on Free Software](http://ometer.com/hacking.html)
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]