WWW-www.enlightenment.org pushed a commit to branch master. http://git.enlightenment.org/website/www-content.git/commit/?id=fe9c679775704f73c18e6f3f9dcf6bcefe871524
commit fe9c679775704f73c18e6f3f9dcf6bcefe871524 Author: Gareth Halfacree <[email protected]> Date: Fri Nov 17 07:14:27 2017 -0800 Wiki page start.md changed with summary [created] by Gareth Halfacree --- pages/contrib/docs/start.md.txt | 60 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) diff --git a/pages/contrib/docs/start.md.txt b/pages/contrib/docs/start.md.txt new file mode 100644 index 00000000..eb4735e7 --- /dev/null +++ b/pages/contrib/docs/start.md.txt @@ -0,0 +1,60 @@ +--- +~~Title: Documentation Contributions~~ +~~NOCACHE~~ +--- + +# Documentation Contributions # + +The Enlightenment Project welcomes contributors to its documentation efforts, whether as simple as fixing a typographical error or creating a new in-depth reference article. Good documentation should be at the heart of any project, and the Enlightenment Project is no exception. + +Before contributing, please take the time to read through the following documentation. + +## Document Contribution Guide ## + +To ensure consistency and quality between multiple authors the Enlightenment Project has an official [Documentation Contribution Guide](https://www.enlightenment.org/contrib/docs/documentation-guide.md) which explains the format, style, and layout of official documentation. + +While contributors to the Enlightenment Project are located all around the globe, just like its users, all official documentation is written and published in American English. The [Documentation Contribution Guide](https://www.enlightenment.org/contrib/docs/documentation-guide.md) contains further details on grammar and syntax, as well as technical information about the Markdown Extra markup language in which documents are formatted. + +## Eolian Documentation Guide ## + +Developers working with the Enlightenment Foundation Library may also wish to contribute to the documentation contained within the application programming interface itself in the form of *Eolian files*. If so, the [Eolian Documentation Guide](https://www.enlightenment.org/contrib/docs/eo-guide.md) contains information on the format of the ``.eo`` files which contain the Eolian documentation. + +Note that selected conventions from the [Documentation Contribution Guide](https://www.enlightenment.org/contrib/docs/documentation-guide.md), such as the use of American English, apply here as well as in general documentation. + +More information is also available in the [Eolian File Format Specification](https://www.enlightenment.org/contrib/docs/eo.md), which provides a quick reference to the format of Eolian files. + +## Using DokuWiki ## + +The Enlightenment Project's documentation is held on the website using the DokuWiki content management system. Anyone wishing to contribute will need to [register a user account](https://www.enlightenment.org/?do=register) using a valid email address, providing both a user name and their real name. + +DokuWiki user accounts can be used to edit existing documentation as well as create new pages. For more information on DokuWiki consult the [DokuWiki Manual](https://www.dokuwiki.org/manual). + +## Additional Documentation ## + +Although all primary documentation is stored on the main website, selected technical documentation is instead located on the [Phabricator Ticket System Wiki](https://phab.enlightenment.org/w/). Where a document is available on both DokuWiki and Phabricator, the DokuWiki version should be considered canonical. + +If you encounter documentation available exclusively on the Phabricator Ticket System Wiki consider rewriting it in Markdown Extra format and uploading it to DokuWiki for easier access. + +## IRC Channels ## + +The official Enlightenment IRC channels, hosted on the Freenode network, are often the quickest way to communicate with Enlightenment developers. Available in English, German, French, and Korean, the channels are accessible 24/7 and are open to both developers and end-users, and can provide instant feedback or answers to queries raised as you work on documentation. + +Connection information is as follows: + +| IRC Server | Port | Channel | Topic | +|------------------|------|---------|-----------------| +| irc.freenode.net | 6667 | #e | General | +| irc.freenode.net | 6667 | #e.py | Python-related | +| irc.freenode.net | 6667 | #e.bsd | BSD-related | +| irc.freenode.net | 6667 | #e.de | General - German| +| irc.freenode.net | 6667 | #e.fr | General - French| +| irc.freenode.net | 6667 | #e.kr | General - Korean| + +## Mailing Lists ## + +The Enlightenment Project maintains several mailing lists, full details of which are available on the [Contact page](https://www.enlightenment.org/contact). The lists of interest to a documentation contributor, which are available in English only, are as follows: + +| Mailing List | Archive | Topic | +|----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|------------------------------| +| [enlightenment-devel](http://lists.sourceforge.net/lists/listinfo/enlightenment-devel) | [SourceForge](http://sourceforge.net/mailarchive/forum.php?forum_name=enlightenment-devel) | E/EFL development discussion | +| [enlightenment-announce](http://lists.sourceforge.net/lists/listinfo/enlightenment-announce) | [SourceForge](http://sourceforge.net/mailarchive/forum.php?forum_name=enlightenment-announce) | E/EFL announcements | \ No newline at end of file --
