Ooops, I just noticed the main wiki page http://trac.symfony-project.com/wiki has a list of translated docs.
However, I would suggest to create wiki/Documentation as well, for a better navigation experience. Translation list could be moved there with all Documentation focused resources such as http://trac.symfony-project.com/wiki/Documentation/HowTo . Additionally, as described in my previous message, not all Docs follow guidelines provided here http://trac.symfony-project.com/wiki/Documentation/HowTo and guidelines are missing information about which other resources could/should/must be published (such as discussion pages). Any feedback? On Nov 10, 4:37 pm, Simone Carletti <[EMAIL PROTECTED]> wrote: > Hi list, > > I have to admin I'm feeling a bit confused. > Today I wanted to have a look at the progress of the Italian > documentation to give my help. > > First, I had to find where documentation has been saved on Wiki. > On the site I didn't find any link (for example from official > documentation) pointing to localized version (perhaps with a small > advice: help us to translate...). > I had to find and follow the link starting from the weekly newsletter > published on the blog. > > I'm from Italy, thus I first opened the Italian translation, currently > under development. > The link is > herehttp://trac.symfony-project.com/wiki/Documentation/it_IT/book/1.0 > Because I'm fundamentally a curious developer I decided to trim the > URL tohttp://trac.symfony-project.com/wiki/Documentation/it_IT/(an > hypothetic Italian homepage) and I found it contains the same TOC of > the other page. > > At the beginning I didn't take care of that. > Then I had a look at a few pages and I decided I wanted to apply a few > fixes. > Because I contribute to many other open source projects I know how > discussions are important thus I tried to find a place where > communicate with other Italian translators... I didn't find it neither > in the forum, between groups or in Trac! > > That's bad. How do the other translators work? > I had a look at > France.http://trac.symfony-project.com/wiki/Documentation/fr_FRincludes > "pointless" information while this > pagehttp://trac.symfony-project.com/wiki/Resources/fr_FR > it's an excellent starting point. > I found it > fromhttp://trac.symfony-project.com/wiki/Documentation/fr_FR/book/1.0 > where there is the book TOC and this precious link. > > Let me say you French guys have an excellent organization. You > published all information a person like me needs to know to contribute > to a translation. > See, for > examplehttp://trac.symfony-project.com/wiki/Documentation/fr_FR/HowToContribute > > But... why all pages belong > tohttp://trac.symfony-project.com/wiki/Documentation/fr_FR/ > "namespace" whilehttp://trac.symfony-project.com/wiki/Resources/fr_FR > not? > > I had a look at the other localized documentations and I think it > could be better to suggest a shared guideline to organize them. > For instance, I suggest > > 1. The main documentation root (http://trac.symfony-project.com/wiki/ > Documentation/) cannot be empty. it should, at least, list all > localized documentation perhaps with completation progress. > Curious guys like me will be able to read more information when > trimming URLs. > > I'm going to create this page in the next hours, let me know if you do > not agree. > > 2. The main language root (http://trac.symfony-project.com/wiki/ > Documentation/<lang>/) should be considered as an homepage. > It should include a link to all available book TOCs (for instance 1.0 > trunk and 1.1 trunk). > > Additionally, it could list resources and point to other useful pages. > See for examplehttp://trac.symfony-project.com/wiki/Documentation/de_DE > andhttp://trac.symfony-project.com/wiki/Documentation/fr_FR > > 3. All localized pages should belong > tohttp://trac.symfony-project.com/wiki/Documentation/<lang> > namespace. > If for somewhat reason they have to be stored in other directories > such ashttp://trac.symfony-project.com/wiki/Resources/fr_FR, I would > suggest to createhttp://trac.symfony-project.com/wiki/fr_FRas well. > > 4. Documentation should include an explanation about where translation > discussion take place. > I saw a few countries decided to use groups, others to use wiki pages. > > For instance, in Italy the group symfony-it has been created but I > didn't know who is in charge of it and it contains only 2 posts. > I'm going to try to contact group admin and check whether it could be > used for translators as well. > > Additionally, a section could be reserved on the forum. > Any other suggestions? > > 5. Any other proposals? > > I'm curious to know your opinion about this topic. :) > Sorry for the long long post. > > -- Simone --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "symfony developers" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/symfony-devs?hl=en -~----------~----~----~----~------~----~------~--~---
