<div class="gmail_quote">2012/3/2 Marc Santhoff <span dir="ltr"><<a href="mailto:M.Santhoff@web.de">M.Santhoff@web.de</a>></span><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Maybe it's a bit more than only improving documentation itself. The<br>
project management part of it is to care for keeping docs up to date and<br>
keep the shape following the needs. An example would be some kind of<br>
general info pages about how the project is driven. Special index pages<br>
or future plans come to my mind here.<br></blockquote></div><br>There is already such page :<br>  <a href="http://wiki.lazarus.freepascal.org/Lazarus_Development_Process">http://wiki.lazarus.freepascal.org/Lazarus_Development_Process</a><br>
but it is difficult to find. I plan to update it and get a link somehow to main page (if I had rights).<br>Now only there is something badly wrong with the wiki server. It is very slow, browser timed out when I tried to update something.<br>
<br>There is already a link for developers page in Development_Process page.<br>I was thinking to explain the tools used and project organization, too.<br>================================<br><br>Tools:<br>-------<br>There are 6 web-based -tools to help manage the development and to communicate.<br>
* Lazarus main web page (<a href="http://www.lazarus.freepascal.org">www.lazarus.freepascal.org</a>).<br>* Forum (<a href="http://lazarus.freepascal.org/index.php?action=forum">http://lazarus.freepascal.org/index.php?action=forum</a>).<br>

* Mailing list (<a href="mailto:lazarus@lists.lazarus.freepascal.org">lazarus@lists.lazarus.freepascal.org</a>).<br>
* Chat line (#lazarus-ide).<br>
* Wiki pages (<a href="http://wiki.lazarus.freepascal.org">http://wiki.lazarus.freepascal.org</a>).<br>  They document Lazarus usage and internals. Can be edited by anyone after logging in...<br>* Issue Tracker for reporting both bugs and feature requests.<br>
  It supports also simple project management features. A bug can be assigned to a developer and its target release and priority can be set.<br>
<br>For documenting LCL library there is Documentation Manager (?) and FpDoc.<br>The source document files are XML, many help file formats can be generated from them. Links... <br><br>For creating program code Lazarus itself is used (naturally).<br>
<br>Organization:<br>----------------<br><br>___ Developing program code and applying patches ___:<br> The recommended way to contribute code for Lazarus sources is to first create a patch (link Creating_a_Patch) and then upload it to a new report in issue tracker.<br>
 The developers with commit rights verify the patch and apply it if valid.<br> See Developers_Page for info about developers and their areas of expertise.<br><br>___ Web-tool administration, the responsible person ___:<br>
 Server with Lazarus main page and Forum: ???<br> Mailing list server: ???<br> Chat server: ???<br> Wiki server: Vincent Snijders<br> Mantis Issue Tracker server: ???<br><br> In the other thread "Missing Documentation" Vincent mentioned he doesn't want to continue as wiki admin.<br>
 Samps Okholm and Richard Mace immediately offered their help. It would be stupid not to accept it, IMO.<br> I have no idea who are the admins for the other servers. Maybe the info is buried somewhere in wiki.<br> The web tools work well except for the wiki. The search is poor and now it is slow.<br>
<br>___ Public Relations ___:<br> The goal is to advertise Lazarus on different ways. Internet sites related to programming languages / tool and Linux distributions may be good candidates.<br> More frequent Lazarus releases will also work as a (semi-)automatic advertisement. Release announcements are typically notified on many sites.<br>
 The responsible person  : Position is open!<br><br>___ Release schedule ___: (the page already has info of releases up to 0.99)<br> A new time-based release schedule will be used (! note, this is my proposal and not approved by other devels but there are signs it could be approved !).<br>
 Until now the release cycle has been long. It requires a set of bugs to be fixed and then verifying the quality with a test period. Now Lazarus is mature enough for a time-based schedule.<br> Most other mature projects have it, too.<br>
 This has at least 2 benefits.<br>  1. Users would not need to use the development version only because the released version is so old.<br>  2. A release announcement works as a free advertisement. (See Public Relations).<br>
<br>___ Release Management ___:<br> Release Manager person: Vincent Snijders<br> Build tester for Windows: Position is open!<br> Build tester for Mac: Position is open!<br> Build tester for Linux Debian: ???<br> Build tester for Linux RPM: Position is open!<br>
 Build tester for BSD: Position is open!<br> Build tester for xxx: Position is open!  (I don't remember all platforms supported)<br>
<br> Now the fact is that Vincent has less time and energy than before for this task.<br> It may be that  Release Manager position is open, too. (Correct me Vincent if I am wrong)<br> Build testers are needed because (according to Vincent) the building itself is easy if you have a remote connection (ssh) to a server but you can't test a graphical program on that server.<br>
<br>___ Updating Fixes Branches ___:<br> Bug fixes are backported from trunk to the fixes branch by these people:<br> 0.9.30.x: Vincent Snijders / Juha Manninen<br> 0.99.x: Maybe Juha Manninen (=me)<br><br>================================<br>
<br>That was the Development_Process page.<br>The Developers_Page would list also other prominent contributors, not only core developers.<br>They can be called SMEs (subject matter experts) if needed. It would not really change their position but just make it more visible to new people.<br>
<br>The updated page would improve the first impression for new potential users / contributors and make things more visible, as was requested.<br>It also adds tasks which didn't exist before (Public Relations) and clearly states some positions to be open.<br>
So yes, it tries to fix the project's organization and management, too, not only documentation.<br><br>The development process itself works very well. This includes the people (SMEs or whatever) answering questions on mailing list and on Forum.<br>
You guys failed to see that because you have not participated in the development.<br>Many other things around it don't work as well. Partly it is because the project is getting mature.<br>Things like "First Impression" and "Public Relations" were not important with the early, buggy versions of Lazarus but now they are.<br>
<br>Other developers would need to :<br>- approve the ideas (unless they are wrong)<br>- approve some people for open positions<br>- figure out who has admin rights to the web-tool servers and pass the keys forward if needed.<br>
<br>I also hope this doesn't lead to another endless debate ...<br><br>Juha<br><br>