Re: [Tails-dev] Contribute section of the website: categorie…

Supprimer ce message

Répondre à ce message
Auteur: intrigeri
Date:  
À: The Tails public development discussion list
Sujet: Re: [Tails-dev] Contribute section of the website: categories
sajolida@??? wrote (11 Oct 2013 16:59:27 GMT) :
> I created a new blueprint to work on that:


> https://tails.boum.org/blueprint/contribute_section/


> The original list of links is huge. For it to be helpful I think we
> should limit the number of links that appear on the main contribute
> page, while providing a good way of going deeper in the sections once
> you know where to click. Then different sections can have their own
> table of content, like the design documents for example.


> To keep that content compact I created a bullet list with a bit some
> hierarchy but avoided complete sentences. The title of the page should
> speak by itself, and when needed, we can add more info outside of the
> link, like "[[APT repository]], to store our custom Debian packages."


> What do you think? Feel free to move things around to put the most
> relevant first, and remove or add more links.


I like it.

>>   * Replace the "Design" section with a single link to
>>     contribute/design. I suggest we simply put this link in the same
>>     section as the link to blueprints, and rename "Tools" into
>>     something else.


> I called it "Reference documents" = Design + Blueprints.


Good.

> I renamed tools as "Development tools".


I'm not sure designers and doc writers would feel welcome into this
section with this name. But perhaps pointing to the revelant Redmine
custom queries from contribute/how/* is enough. Your call.

>>   * About the huge "Other development pages" index, I propose we create
>>     a ticket for filtering out what shouldn't be there, and creating
>>     index pages for every sub-directory of contribute as needed, so that
>>     we can make the list way shorter by only pointing to the relevant
>>     pages. I don't think this should block the deployement of the fix
>>     for #6173, though.


> The downside this is that we won't take advantage of the automatic
> indexing anymore. Maybe we could still have an automatic indexing of a
> section on the index of the section. The downside of this, is that we
> might have to move quite a few pages around so that the source tree
> matches the logical sections we want to create.


Moving these pages around looks like an improvement to me, actually.

Cheers,
--
intrigeri
| GnuPG key @ https://gaffer.ptitcanardnoir.org/intrigeri/intrigeri.asc
| OTR fingerprint @ https://gaffer.ptitcanardnoir.org/intrigeri/otr.asc