[GRASS-dev] Using Trac wiki for documenting development during GSoC

Vaclav Petras wenzeslaus at gmail.com
Sat Apr 6 14:30:08 PDT 2013


Hi all,

it would be better to announce and discuss this sooner but still I
hope that it will be considered for future work.

According to what was discussed during Community Sprint Genova [1],
the proposals and progress related to development during GSoC should
be held at the (GRASS) Trac Wiki. The GRASS Wiki should not be used to
this because it is intended to document existing features and
procedures not the development of features. So, the currently achieved
results of GSoC should be at GRASS Wiki.

Vaclav

[1] http://grasswiki.osgeo.org/wiki/Talk:GRASS_Community_Sprint_Genova_2013#Vaclav_Petras


== Examples of pages which are at GRASS Wiki and Trac Wiki (from wxGUI) ==

https://trac.osgeo.org/grass/wiki/wxGUIDevelopment/wxIClass
http://grasswiki.osgeo.org/wiki/WxIClass

https://trac.osgeo.org/grass/wiki/wxGUIDevelopment/Modeler
http://grasswiki.osgeo.org/wiki/WxGUI_Modeler

https://trac.osgeo.org/grass/wiki/wxGUIDevelopment/GUIForPs.map
http://grasswiki.osgeo.org/wiki/WxGUI_Cartographic_Composer

https://trac.osgeo.org/grass/wiki/wxGUIDevelopment/vkrige


== Syntax ==

Unfortunately, Trac wiki uses different syntax than MediaWiki, so one
have to use both to properly document the work at Trac Wiki and GRASS
Wiki.

http://grasswiki.osgeo.org/wiki/Help:Editing
https://trac.osgeo.org/grass/wiki/WikiFormatting
https://trac.osgeo.org/grass/wiki/WikiRestructuredText


== Content ==

The GRASS Wiki:
* manual enhancement
* howtos for users (e.g., how to do classification)
* howtos for power users, testers and developers (e.g., how to compile)
* howtos for developers (e.g., grass python programming)
* ...

The (GRASS) Trac Wiki:
* collecting proposals
* how the development of some part is going
* notepad for developers


== The rule strength ==

Since it is not absolutely sure what should be where, it is not
required to follow this rule, it is only strongly recommended for new
pages.

For GSoC, it is even less clear because it would be better to be more
accessible, i.e use more known MediaWiki syntax at GRASS Wiki. But
maybe it is not so difficult to use both wikis.

For existing pages, some of the pages should be definitely moved,
especially those messy pages (or its parts) with many proposals should
be moved. However, manpower should not be wasted for the quick
migration, especially when it was some similar consideration but with
different result some time ago (all development related pages such as
compiling was about to move to Trac).


== Example pages with content which should be at Trac Wiki ==

http://grasswiki.osgeo.org/wiki/Toolboxes
http://grasswiki.osgeo.org/wiki/WxGUI#Direct_printing
http://grasswiki.osgeo.org/wiki/WxPython-based_GUI_for_GRASS#General_GUI_Design


More information about the grass-dev mailing list