content: Restructure using the Diátaxis approach #2996
Description
Top-level sections per the Diátaxis approach:
- Tutorials
- Concepts
- Guides
- Reference
Additional top-level sections that do not belong in the above:
- Contribute
- Glossary
- Installation
- Troubleshooting
Other issues to be addressed while the body's open:
- Proposal: HugoDocs Guides #389
- Define an upgraded structure and sections for improving tutorial & how-to docs #1289
- Truncate the /tools section #1573
- Cleanup and improve taxonomy pages #2218
- Combine some of the content management pages #2307
- Hugo modules - move overview content to an introduction page #2308
- Themes section #2355
- Describe usage of logical path with relevant methods, functions, and shortcode #2448
- Pipes section needs more introduction material #2461
- Add taxonomy term naming rules/guidelines #2465
- Document the different ways to configure authors #2494
- Document restricted first character for content files without front matter #2703
- Quickstart is too short #2747
- Consolidate the Hugo Pipes section into a single page #2850
- content: Add tutorial for image placement #3129
- content: Add introductory page to the "Host and Deploy" section #3139
- content: Document how to customize the 404 page title #3036
- content: Replace shortcut references with collapsed references #3172
- content: Document versioned module imports #3200
- Add Cloudflare hosting guide
- Add Render hosting guide
- Add Vercel hosting guide
See also:
Site structure and status
- about/
- introduction
- features
- security
- license
- docs/
- installation/
- bsd
- linux
- macos
- windows
- tutorials/
- quick-start
- tbd-1
- tbd-2
- tbd-3
- external-learning-resources
- concepts/
- archetypes
- asset-pipelines
- content-adapters
- content-formats
- content-summaries
- data-sources
- front-matter
- localization
- markdown-attributes
- markdown-render-hooks
- menus
- modules
- pagination
- project-structure
- shortcodes
- syntax-highlighting
- taxonomies
- template-types
- templating
- themes
- unified-file-system
- url-management
- guides/
- asset-pipelines/
- css
- imaging
- javascript
- sass
- tailwind
- authors
- build-options
- comments
- content-adapters
- custom-shortcodes
- diagrams/
- goat
- mermaid
- embedded-shortcodes/
- embedded-partials/
- disqus
- google-analytics
- opengraph
- pagination
- schema
- twitter cards
- embedded-templates/
- alias
- robots
- rss
- sitemap
- sitemapindex
- host-and-deploy/
- mathematics-in-markdown
- menus
- multilingual-sites
- related-content
- taxonomies
- asset-pipelines/
- reference/
- commands/
- content-adapters
- configuration/
- functions/
- markdown-render-hooks/
- methods/
- miscellaneous/
- quick-reference/
- troubleshooting/
- audit
- deprecation
- faq
- inspection
- logging
- performance
- glossary
- contribute/
- development
- documentation
- themes
- installation/
- news/