A 2016-09-24 13:57, robert escrigué: > Hello, Hi Rob, first of all, thanks for your message! Sorry it has taken so long to respond. I'll reply inline.
> I have some proposals for changes to the wiki Installation pages. > > I have two concerns. First, everyone will be accustomed to the current > placement of information. Second, the Apertium wiki is deep in > information, built by many people over a long period, and I have no > wish > to loose information, or spoil what I find to be one of the most > charming wikis I have ever browsed. Thanks for the kind words, you're right it has developed quite organically. > == Background > A week and a half ago I was entirely new to Apertium, and installation > of a development environment caused me trouble. The Apertium wiki > contains a lot of information, very good information, but now > disorganised. I found myself working across three pages, with many > other > pages I felt I may have missed (I found another page this morning, not > in the category 'installation', where it arguably should be, > http://wiki.apertium.org/wiki/How_to_bootstrap_a_new_pair ) > > There is a lot of work I could look at on the wiki, but this has sucked > me in. Yes, the installation instructions really need to be completely reworked, and the out of date ones deprecated. Basically people need to be pointed to the packages first. There should not be any distribution specific install instructions any more (or they should have a big warning "Deprecated" on the page). The compile instructions should be streamlined. > > == The proposals > I have a set of new/revised pages. These have been prepared by cutting > and pasting the originals, preserving all current material. The changes > are too many to list, with much re-ordering. The new pages would be, > Do you think you could make a mock-up of the new front page in a subpage of your user page ? > === Revised installation front page > - Deflect users who want tools (the page is called 'installation' and > they could easily arrive here) to 'tools' > - Main entry "Using package repositories and virtual environments" > Put these two on a level and up front. They are the way forward for > most > people. So these options are first, not compiling. > - Remove all references to compiling (prerequisites etc.) > - A link to a modified 'Minimal installation from SVN' page > - A link to "Installing language data" Excellent ideas. > > === Install language data how-to > Gathered on one page. > - Language data will need to be compiled, but if using packaged > apertium-core the prerequisites are fewer. > - If you have a dev environment, you want this information in one > place, > not mixed with other instructions. > > > == Install grammar libraries > Separate page suggesting Debain users try the packages > - After that, point to compile instructions > > > === Revise "Minimal installation from SVN" (more like "apertium core by > compiling") > - Full prerequisite info here (the only place it is relevant) > - Move some material. No need to start with > warnings, due to revised front page. Language and CG3/HFST data > installation can now be linked. > > > I do understand if this is too much, in too sensitive an area of the > wiki. But then, I wish all the good information I have found in the > last > week was easier to find... Again thanks for this! I agree with a lot of your points :) I think the best idea, given the wideness of the changes would be to make mockups of the replacement pages under your User page and then post them to the list to get checked. It goes a bit against Wiki culture, but I think that given how often these pages are looked at it might be a nice idea. F. ------------------------------------------------------------------------------ _______________________________________________ Apertium-stuff mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/apertium-stuff
