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

Delete this message

Reply to this message
Author: sajolida
Date:  
To: The Tails public development discussion list
Subject: Re: [Tails-dev] Contribute section of the website: categories
> 1. I think this mockup is already much better than the current page,
>    so I propose we deploy it live as is.


Done: https://tails.boum.org/contribute/.

> 2. We should add some content to implement the latest proposal by
>    sajolida, that was roughly taken from Fedora's website IIRC
>    (basically: a short description for each sub-category such as
>    Writer and Software Developer, and a "Learn more" link, IIRC).

>
> 3. Once we have all the needed content, we can ask carmie to do
>    some styling.


I created a bunch of subtickets to finish this work:

https://labs.riseup.net/code/issues/6165

> 4. In parallel with the CSS work, the next step is probably to tidy up
>    the rest of the contribute page somehow. Else, with this biggest
>    introduction, it will get a bit too long. Here's a quick initial
>    proposal to get us started:


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.

>   * 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.
I renamed tools as "Development tools".

>     Rationale: the list of individual design docs is already on
>     https://tails.boum.org/contribute/design/#index3h1 (it could
>     perhaps be moved to the top to be more visible there, though)

>
>   * Move the "Talk to us" section, unchanged, above the "Other
>     development pages" one.

>
>   * 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.