Move from Administration to Advanced Functionality #66
Conversation
Andrea-Campanella
requested review from
achamuah,
swpng,
zdw,
ajaythakurintel and
patricia-cahill
as code owners
| @@ -1,8 +1,9 @@ | |||
| Administration | |||
| Advanced Functionality | |||
There was a problem hiding this comment.
maybe we should do a logical split: Admin page related functionality (to stay as Adminstration) and Advance Functionality (the rest)
| more advanced tasks such as administrative ones to customize or extend the | ||
| application's capabilities: | ||
|
|
||
| * :doc:`/user_guide/advanced_functionality/set_up_a_cluster_template` |
| @@ -0,0 +1,27 @@ | |||
| Advanced Functionality | |||
There was a problem hiding this comment.
Does the directory name need to match this title? Using just advanced for the path would result in shorter URLs.
There was a problem hiding this comment.
I'd say it's a good practice to overlap filenames and titles (with some abbreviations).
I'd even go further: I favor putting the parent article in the same directory as the folder with its children, and naming the folder the same as the file... This way you get a very consistent URL structure :) And if you put in an incomplete URL of a file, you may still get a page instead of 404. like so:
|- section-1
|- advanced
|- article-1.rst
|- article-2.rst
|- advanced.rst
|- section-1.rst
./edge-management/advanced.html
./edge-management/advanced/article-1.html
I know... Off-topic :)
PR Description
Move from Administration to Advanced Functionality for the top level bullet.
Checklist