Re-organize of documentation, moving content from "all-manuals" to parent site "documentation"

5 respostas [Última entrada]
knife

I am a member!

Desconectado
Joined: 01/02/2019

Hello,
I got a a question to the community about a documentation related issue:
I think the content of https://trisquel.info/en/wiki/all-manuals would fit better to https://trisquel.info/en/wiki/documentation, the first site you see, when clicking on "documentation" at the navigation bar on top of Trisquel's website.
So I would like to copy the content of "all-manuals" to "documentation", right after the section "We are here to help!"

Because the content of "all-manuals" is the most important part when navigating through the wikis, it should be more visible. Also, when clicking "up"(several times) at the button of the wikis you are linked to https://trisquel.info/en/wiki/documentation, the parent site, where the manuals are out of sight for now.

Because it means a bigger change on the wiki, I just want to ask you, the community, about your opinion.

Regards

eric23
Desconectado
Joined: 06/30/2017

You want to merge those pages, but to me doing that might make it more cluttered. All Manuals is a large page. Maybe making words "All Manuals" in documentation more prominent rather a merge would work out better. The directory "Philosophy -> recovering d-i logs" maybe could be made in alphabetic order to make it easier to find things. That directory could also use some cleaning like moving omnidemos and Recovering d-i logs to "All Manuals" or maybe somewhere more relevant.

knife

I am a member!

Desconectado
Joined: 01/02/2019

Another possibility would be to set the category pages (Philosophy, About Trisquel,... ) as child pages of "all-manuals", so "up" from "Philosophy" will link to "all-manuals" and not "documentation".

Maybe making words "All Manuals" in documentation more prominent rather a merge would work out better.

That's also a good idea, and together with the other change it will lead to a good solution.
.

Avron

I am a translator!

Desconectado
Joined: 08/18/2020

The directory "Philosophy -> recovering d-i logs" maybe could be made in alphabetic order to make it easier to find things.

This index is not written manually in the page, it seems to be generated automatically from all pages listed as "child pages". When looking at "Edit" of a child page, at the end of "Book outline", there is a "Weight" and text that says "Pages at a given level are ordered first by weight and then by title.".

In this index, the pages from "Philosophy" to "Trisquel Community Guidelines" have weights from -15 to -1, with the weight increased by 1 for each page, then the next 3 pages have a weight 0 and the last one a weight 13.

My guess is that, except for weights 0, these weights were set manually and I do find some logic in the current order, so I would try to do small improvements to it rather than make it purely alphabetical.

That directory could also use some cleaning like moving omnidemos and Recovering d-i logs to "All Manuals" or maybe somewhere more relevant.

I fully agree for the last 3 ones. The issue seems to be that these pages are "child pages" of the top page. I will do something for that.

For the Portuguese page, I am not sure what to do. There is no option for Portuguese language on the website, which may be the reason why it is declared as an English page. The best would be to add Portuguese as a language. If that is not feasible, I need to think about another idea to make it somehow more visible and not inside a list of English pages.

making words "All Manuals" in documentation more prominent

Another way could be to move all pages listed before "all manuals" in the index as child pages of "all manuals" (instead of child pages of the top page like now). But since it is a bit drastic change, I would like to think more about it first.

knife

I am a member!

Desconectado
Joined: 01/02/2019

I fully agree for the last 3 ones. The issue seems to be that these pages are "child pages" of the top page. I will do something for that.

I thought about the 3 lonely ones. In my my opinion we should move:

omnidemos to Settings->Graphic User Interfaces (GUIs)
Recovering d-i logs to Development
Escaping the Javascript-Trap to Home and office->Internet

Another way could be to move all pages listed before "all manuals" in the index as child pages of "all manuals" (instead of child pages of the top page like now). But since it is a bit drastic change, I would like to think more about it first.

Like I wrote, I think that would be a good solution. But first, let's see what other users think.

Regards

Magic Banana

I am a member!

I am a translator!

Desconectado
Joined: 07/24/2010

What about just listing the "category pages" on https://trisquel.info/en/wiki/documentation after a small text explaining that the documentation is hierarchically organized?

Some of the category pages are not up-to-date though. For instance, https://trisquel.info/en/wiki/about-trisquel does not include https://trisquel.info/en/under-what-license-trisquel-distributed and https://trisquel.info/en/faq that https://trisquel.info/en/wiki/all-manuals lists under "About Trisquel". It does not seem possible to define a parent page in https://trisquel.info/en/node/1855/edit (because it is very old?) and https://trisquel.info/en/faq cannot be edited. Nothing insurmountable though.

In other words, I feel it would be better to (even partially) fix the hierarchy instead of making it flat, with every manual having https://trisquel.info/en/wiki/all-manuals as a parent. I am *not* suggesting to get rid of https://trisquel.info/en/wiki/all-manuals (where there is no need to navigate a hierarchy to find something Ctrl+F directly brings). What do you think?