Skip to content

Change home page UI #1875

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 35 commits into from
Mar 16, 2025
Merged
Show file tree
Hide file tree
Changes from 8 commits
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
ad934cb
change UI
Manas-Kenge Feb 28, 2025
9a06b52
add icons
Manas-Kenge Mar 1, 2025
78c62ec
add reference guide
Manas-Kenge Mar 2, 2025
2294a64
Remove bullet points
Manas-Kenge Mar 2, 2025
b088e5e
Merge branch '6.0' into home-page-UI
stevepiercy Mar 3, 2025
1cffd28
add additional cards
Manas-Kenge Mar 3, 2025
f7fe81f
Merge branch '6.0' into home-page-UI
Manas-Kenge Mar 4, 2025
ac3efc1
use internal links for cards
Manas-Kenge Mar 5, 2025
0fd234d
modify descriptions
Manas-Kenge Mar 6, 2025
d8eac2e
restore submodules
Manas-Kenge Mar 7, 2025
49c9950
Merge branch '6.0' into home-page-UI
Manas-Kenge Mar 7, 2025
2bdf87e
Merge branch '6.0' into home-page-UI
stevepiercy Mar 7, 2025
8bbef95
Merge branch '6.0' into home-page-UI
stevepiercy Mar 7, 2025
984c646
Merge branch '6.0' into home-page-UI
stevepiercy Mar 7, 2025
ba25739
Merge branch '6.0' into home-page-UI
Manas-Kenge Mar 9, 2025
d842506
Merge branch '6.0' into home-page-UI
stevepiercy Mar 9, 2025
171dd09
Merge branch '6.0' into home-page-UI
stevepiercy Mar 10, 2025
5ff36ce
Fix button-ref link syntax and use backtricks instead of colons
stevepiercy Mar 10, 2025
314c923
Remove HTML from metadata
stevepiercy Mar 10, 2025
f832bac
Now that we have cards on the index page, remove redundant sections f…
stevepiercy Mar 10, 2025
feb3fd5
Align Get Started card with its content
stevepiercy Mar 10, 2025
6beb0ab
Exclude files from plone.restapi to avoid errors
stevepiercy Mar 10, 2025
a37493c
Shorten text in user guide card
stevepiercy Mar 10, 2025
3727e56
Fix broken references
stevepiercy Mar 10, 2025
256ac2b
Create bogus editor.md page and add sphinx-reredirect entry to send i…
stevepiercy Mar 10, 2025
21456be
Merge branch '6.0' into home-page-UI
Manas-Kenge Mar 11, 2025
98d2989
Fix typo
stevepiercy Mar 12, 2025
dcbdf3d
- Set up a collection of reference guides as a definition list
stevepiercy Mar 12, 2025
c068205
Update the name of the navigation item
stevepiercy Mar 12, 2025
9e959ae
Update the user guide index to use a definition list
stevepiercy Mar 12, 2025
b98e823
Merge branch '6.0' into home-page-UI
stevepiercy Mar 13, 2025
777f253
Merge branch '6.0' into home-page-UI
stevepiercy Mar 14, 2025
fb27598
Merge branch '6.0' into home-page-UI
stevepiercy Mar 14, 2025
e5b1174
Merge branch '6.0' into home-page-UI
stevepiercy Mar 14, 2025
646f628
Merge branch '6.0' into home-page-UI
stevepiercy Mar 15, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
101 changes: 95 additions & 6 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,100 @@ myst:

This is the community-maintained documentation for the Plone content management system.

This documentation is for:
:::::{grid} 1 1 2 2
:gutter: 3 3 4 5

- Editors who write and update content on a site
- Site administrators who install Plone and add-ons, and set up a site
- Designers who create site themes
- Deployers who configure servers for site hosting
- Developers who customize a site’s capabilities, create add-ons, and contribute to Plone itself
::::{grid-item-card}
:link: install/index
:link-type: doc
{octicon}`zap;1.5em;sd-text-info`
Get started
^^^
This part of the documentation helps you find the best way to get started with Plone, depending on what you want to do.
+++
```{button-ref} {doc} install/index
:color: primary
:expand:
Go to Get started
```
::::

::::{grid-item-card}
:link: user-guide/index
:link-type: doc
{octicon}`person;1.5em;sd-text-info`
User guide
^^^
This part of the documentation helps you understand how to use Plone effectively, covering essential features, navigation, content management, and common tasks for users and administrators.
+++
```{button-ref} {doc} user-guide/index
:color: primary
:expand:
Go to User guide
```
::::

::::{grid-item-card}
:link: developer-guide/index
:link-type: doc
{octicon}`person-add;1.5em;sd-text-info`
Developer guide
^^^
This part of the documentation describes how to develop a Plone site.
+++
```{button-ref} {doc} developer-guide/index
:color: primary
:expand:
Go to Developer guide
```
::::

::::{grid-item-card}
:link: reference-guide/index
:link-type: doc
{octicon}`bookmark;1.5em;sd-text-info`
Reference guide
^^^
This part of the documentation provides explanation of APIs, functions, modules, and objects included in Plone, describing what they are and what they do.
+++
```{button-ref} {doc} reference-guide/index
:color: primary
:expand:
Go to Reference guide
```
::::

::::{grid-item-card}
:link: conceptual-guides/index
:link-type: doc
{octicon}`light-bulb;1.5em;sd-text-info`
Conceptual guides
^^^
This part of the documentation provides explanation of concepts to deepen and broaden your understanding of Plone.
+++
```{button-ref} {doc} conceptual-guides/index
:color: primary
:expand:
Go to Conceptual guides
```
::::

::::{grid-item-card}
:link: contributing/index
:link-type: doc
{octicon}`book;1.5em;sd-text-info`
Contributor guide
^^^
This part of the documentation describes how to contribute to Plone, including all its projects and repositories under the Plone GitHub organization.
+++
```{button-ref} {doc} contributing/index
:color: primary
:expand:
Go to Contributor guide
```
::::

:::::

```{seealso}
Read the [documentation for the previous version, Plone 5](https://5.docs.plone.org/).
Expand All @@ -42,6 +129,8 @@ backend/index
i18n-l10n/index
conceptual-guides/index
contributing/index
reference-guide/index
user-guide/index
```

```{toctree}
Expand Down
22 changes: 22 additions & 0 deletions docs/reference-guide/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
myst:
html_meta:
"description": "Plone reference guide"
"property=og:description": "Plone reference guide"
"property=og:title": "Plone reference guide"
"keywords": "Plone, reference, guide"
---

# Reference guide

This reference guide details application programming interfaces (APIs), functions, modules, and objects included in Plone, describing what they are and what they do.
Its audience is primarily developers of Plone and its projects and add-ons.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@stevepiercy I'm not sure this structure is right. Just because a section of docs covers an API doesn't mean that it's all reference. The lists of endpoints / functions are reference but there's also conceptual and how-to material in there.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a way to solve this by ignoring plone.restapi's and plone.api's index.md files and using custom ones in plone/documentation. It's hard to describe without an example, but it works.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK this is now ready for review. Please take a look at the pull request preview.


## Plone REST API

[Plone REST API](https://6.docs.plone.org/plone.restapi/docs/source/index.html)


## Plone.api

[Plone.api](https://6.docs.plone.org/plone.api/index.html)
22 changes: 22 additions & 0 deletions docs/user-guide/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
myst:
html_meta:
"description": "Plone user guide"
"property=og:description": "Plone user guide"
"property=og:title": "Plone user guide"
"keywords": "Plone, user, guide"
---

# User guide

This user guide details application programming interfaces (APIs), functions, modules, and objects included in Plone, describing what they are and what they do.
Its audience is primarily developers of Plone and its projects and add-ons.

## Plone User Manual

[Plone User Manual](https://6.docs.plone.org/volto/user-manual/index.html)


## Content Editing for Plone

[Content Editing for Plone](https://training.plone.org/content-editing/index.html)
2 changes: 1 addition & 1 deletion submodules/plone.api