blob: 70e65d4b59c4f03209a909d199cf9348ed5cf58d (
plain)
1
2
3
4
5
6
7
|
Please first excuse my english level (and sometimes usage of automatic translation)<div>I have some reflexions and questions i think it could be interesting to share here :</div><div><br></div><div>Doc Team.</div><div><br>
</div><div>_ base : that the documentary team has previously conducted</div><div>_ base : operation for common tools for this job</div><div><br></div><div>_ objective : make participation easy</div><div>_ objective : produce quality docs for readers</div>
<div><br></div><div>_ question : could we mix the usage of wiki and edition ? ;-)</div><div>_ proposition : reserve wiki for contributors works, simply by have a large banner at the top of wiki welcome page (<a href="http://docs.mageia.org">docs.mageia.org</a> ? or whereever). Banner invite to download latest doc compil.</div>
<div><br></div><div>_ effect : no invitation to read wiki. Wiki is ever a working place (as cauldron is dev sys)</div><div>_ effect : Readers and users have ever a validated and finalised documentation</div><div>_ effect : preserve 'works-ever' wiki and prevent any 'never-finished' impression for docs readers</div>
<div>_ effect : make people want to participate by producing a good doc final quality</div><div><br></div><div>No revolution, no new tool, no great idea (sorry :p), just a little orga adjusment to change perception of readers on our doc.</div>
<div>Additonnals : produce in well know format, standard, with easy scanning and indexing for desktop tools (as strigi / nepomuk)</div><div><br></div><div>Resume in two sentences : </div><div>Wiki is for workers. Final doc is for readers, and could include common texts (as releases notes, issues and wiki doc)</div>
<div>Mix wiki usage for edition objective to have separation between places : works and reads.</div><div><br></div><div>Regards</div><div><br></div><div><br></div><div><br></div><div><br></div><div><br></div>
|
