search

developer-portal / content

Content for the Fedora Developer Portal
https://developer.fedoraproject.org/
GNU General Public License v2.0
106 stars 251 forks source link

move pages to proper subsections #237

Closed yotamN closed 3 years ago

yotamN commented 6 years ago

When there are a lot of pages on one subject it will be easier to find what you want with sub pages, for example in PHP there could be frameworks group with Symfony, Zend, CodeIgniter, Laravel etc.

Is it possible in the current template or does it require a change?

pvalena commented 6 years ago

For reference: http://developer-portal.github.io/doc/structure.html

Start a project > Web Application > Laravel ... and Tools > Web Server and Languages > PHP > Web Frameworks

is what makes sense IMHO. Needs a bit of fixing though.

Thans for finding this!

pvalena commented 6 years ago

I think it should say Web Frameworks specifically.

http://developer.fedorainfracloud.org/tech/languages/php/php-frameworks.html

Also, no need to prefix the file with php- when it already is in php subsection.

pvalena commented 6 years ago

I've just learned that we can set permalinks to the duplicated pages. F.e.:

permalink: /tech/languages/php/laravel5.html
yotamN commented 6 years ago

@pvalena In web applications for example you could have HTTP servers, Static Site Generators and Web Frameworks as 3 subsections or probably sub subsections because web applications is the sub section

pvalena commented 5 years ago

That seems to be overcomplication to me... One could simply have a page HTTP servers that has a hyperlink list to other pages.

Like here: http://developer.fedorainfracloud.org/tech/languages/php/php-frameworks.html

pvalena commented 5 years ago

Feel free to submit a PR with any cathegory type of page you thing is missing.

yotamN commented 5 years ago

The example you gave of Languages > PHP > Web Frameworks could stay the same but instead of a page that contains link it will be an expandable list in the sidebar. The content will remain the same, just a bit more organized

pvalena commented 5 years ago

I see, but it is also one level of complexity added and I see very little benefit.

You can have mostly the same effect if you move all the PHP Frameworks bellow the Frameworks page, f.e. That can be Permalinked from the Web application page.

pvalena commented 5 years ago

On top of that, you can actually prefix the page name in the pages list like so:

Frameworks
 - Zend
 - Laravel5
 - [ . . . ]
yotamN commented 5 years ago

Level of complexity to the site development or the content? It's true that the site will need some work to support it but after the initial work I don't think it will be that much complexity to the content writers

pvalena commented 5 years ago

Both... let's try to stick to the current template and use the styling I mentioned instead, which results in mostly the same effect?

Or do you have a different effect in mind? Please note that we do not need any javascrip enabled for this page(apart from search) to work, so any animations or popups are no-go. Also, for easy access, we wan't to show all the subsection pages at once.

I'd rather have the content up-to-date and well-tested, than looking sparkly. It's aimed at the developers, after all.

jackorp commented 3 years ago

Created new issue regarding this: #386