Project

General

Profile

Actions

Task #3229

closed

Introduce "top-level" tags

Added by Olivier Hallot over 3 years ago. Updated almost 3 years ago.

Status:
Closed
Priority:
Normal
Target version:
Team - Q2/2021
Start date:
Due date:
2021-04-11
% Done:

0%

Tags:

Description

Documentation files are well handled by the extension site.

We need a global entry in the main menu for "LibreOffice Documentation", in the same level as "Extension" in the top header.

The menu entry must open the page

https://extensions.libreoffice.org/?Tags%5B%5D=53


Related issues

Related to Extensions - Task #3219: Add more main sectionsClosed

Actions
Related to Extensions - Task #3220: subtagsClosed

Actions
Actions #1

Updated by Olivier Hallot over 3 years ago

  • Related to Task #3219: Add more main sections added
Actions #2

Updated by Heiko Tietze over 3 years ago

  • Status changed from New to Feedback

"Documentation" would be too narrowly considered. If we go with another navigation it would be Templates, Extensions, Documentation selected per dropdown where we currently just have Extensions. The tricky part on this change is the categorization which has to be in addition to the filter per tag system. Some effort but also a lot of benefits IMHO. More opinions needed => FEEDBACK.

Actions #3

Updated by Olivier Hallot over 3 years ago

Main category:
[LibreOffice] Documentation

Sub categories
- Books
- Quick Reference Cards
- Tutorials
- Miscellaneous

Lang Category too.

Note 1: I keep having extension authors tagging their extension with the 'Documentation' tag, and the extension is not a documentation itself (for example, an extension that helps inserting comments in documents). Having a tag 'LibreOffice Documentation' is supposed to make things clearer.

Note 2: It may happen that a document can be tagged in 2 different sub-categories (book + Tutorial)

Note 3: LO users may want to filter documentation by language.

Note 4: It will be nice to have a Silverstripe template to help create redirect pages with a query like the one in comment#0.

Actions #4

Updated by Heiko Tietze over 3 years ago

Sub "categories" should use the existing tag system where you can create any tag you like. If documentation creates many languages tags, for example, it makes sense to not show those at other categories.

Actions #5

Updated by Heiko Tietze over 3 years ago

See also rdm#3220

Actions #6

Updated by Heiko Tietze over 3 years ago

Actions #7

Updated by Heiko Tietze over 3 years ago

  • Subject changed from Menu entry for "LibreOffice Documentation" to Introduce "top-level" tags
  • Status changed from Feedback to New
  • Assignee set to Christian Lohmaier

Discussed in meeting and decided to have a list of tags at a prominent place (eg next to Search) to quick-select Templates, Documentation, and Dictionary. Discussed Extension controversially, so the list of "top-level" tags might change later and has to be flexible.

Actions #8

Updated by Heiko Tietze over 3 years ago

  • Priority changed from Normal to High
Actions #9

Updated by Christian Lohmaier over 3 years ago

  • Target version set to Q3/2020
Actions #10

Updated by Christian Lohmaier over 3 years ago

  • Target version changed from Q3/2020 to Q4/2020

I'll try to add it by end of the year

Actions #11

Updated by Olivier Hallot over 3 years ago

Time has gone. You may drop this demand.

The documentation communtiy did not like the way books were presented in the extension website and criticized to fact that books were seen or presented as extensions.

See :https://listarchives.libreoffice.org/global/documentation/2020/msg01891.html

------8<------
Topics and Discussion:
+ Location of finished books
+ Nextcloud (for developers)
+ Pros
+ Root of all source and published files, no "scattering"
of files
+ Cons
+ clumsy way to download (intermediate page)
+ has LibreOffice Online associated to ODT files

+ Wiki page on published books (for end users)
https://wiki.documentfoundation.org/Documentation/Publications
+ Pros
+ books displays altogether for download
+ Wiki management well known by authors
+ Holds all contents (PDF + ODT)
+ Cons
+
+ Documentation website(for end users)
https://documentation.libreoffice.org/en/english-documentation/
+ Pro
+ easy to get the book
+ quick navigation
+ Cons
+ hard to maintain (must know html, silverStripe CMS)
+ Upload/thumbnails must be manually uploaded/updated
+
+ Extension website (for end users)
https://extensions.libreoffice.org/?Tags%5B%5D=53
+ Pro
+ Very easy to upload and upgrade books
+ Fairly good navigation ("bookstore")
+ feature to give "stars" on the guide
+ Allow comments on Guides direclty from public
+ Cons
+ look unfinished,
+ Confusing mixture with extensions and templates
+ still on test
+ tweaked to fit new "Additions" dialog (7.1)

-----8<------

Actions #12

Updated by Christian Lohmaier about 3 years ago

  • Target version changed from Q4/2020 to Q1/2021
Actions #13

Updated by Christian Lohmaier almost 3 years ago

  • Due date set to 2021-04-11
  • Priority changed from High to Normal
  • Target version changed from Q1/2021 to Q2/2021
Actions #14

Updated by Christian Lohmaier almost 3 years ago

  • Status changed from New to Resolved

basic support for top levels introduced. ATM they are just formatted as bold on the search filter screen.

Actions #15

Updated by Florian Effenberger almost 3 years ago

  • Status changed from Resolved to Closed
Actions

Also available in: Atom PDF