diff --git a/README.md b/README.md index bc3d5014b9..d346908392 100644 --- a/README.md +++ b/README.md @@ -4,13 +4,10 @@ This is the repository for the `go-ethereum` website. All the website code is he The purpose of the go-ethereum website is to provide the necessary documentation and supporting information to help users to get up to speed with using go-ethereum (aka "Geth"). The website is maintained by a team of developers but community contributions are also very welcome. - - ## Contributing Contributions from the community are very welcome. Please contribute by cloning the `go-ethereum` repository, checking out the `website` branch and raising pull requests to be reviewed and merged by the repository maintainers. Issues can be raised in the main `go-ethereum` repository using the prefix `[website]: ` in the title. - ### The geth.ethereum.org stack geth.ethereum.org is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app). The following tools were used to build the site: @@ -28,26 +25,33 @@ geth.ethereum.org is a [Next.js](https://nextjs.org/) project bootstrapped with The website code is organized with a top-level `docs` folder that contains all the documentation pages as markdown files. Inside `docs` are subdirectories used to divide the docs by theme (e.g. `getting-started`,`fundamentals`, `developers` etc). Website code is in `src`, and assets including images are in `public`. - ### Adding a new documentation page Documentation pages are located in the `/docs` folder in the root directory of the project. The docs pages are all markdown files. When you want to add a new page, add the new file in the appropriate folder in the `/docs` page. `index.md` files will be the default page for a directory, and `{pagename}.md` will define subpages for a directory. -Notes in documentation pages are highlighted in pale blue boxes. To add a note, wrap the note text in `` tage as follows: +After adding a page, you will also need to list it in `/src/data/documentation-links.yaml`. This file defines the documentation structure which you will see on the left sidebar in the documentation pages. + +#### Adding notes to a doc + +Notes in documentation pages are highlighted boxes (color depend on the current set dark/light theme). To add a note, wrap the note text in `` tage as follows: ```markdown text to include in note ``` +Screen Shot 2023-01-04 at 18 22 06 + +> Example Note from [Account Management with Clef +](https://geth.ethereum.org/docs/fundamentals/account-management) doc + +#### Images + Images should be saved to `public/images/docs` and included in the markdown as follows: ```markdown ![alt-text](/images/docs/image-title.png) ``` -After adding a page, you will also need to list it in `/src/data/documentation-links.yaml`. This file defines the documentation structure which you will see on the left sidebar in the documentation pages. - - ### Building locally To check a new page it is helpful to build the site locally and see how it behaves in the browser. First, run the development server: @@ -64,4 +68,4 @@ You can start editing the page by modifying `pages/index.tsx`. The page auto-upd ### Review and merge -PRs will be reviewed by the website maintainers and merged if they improve the website. For substantial changes it is best to reach out to the team by raising a GH issue for discussion first. \ No newline at end of file +PRs will be reviewed by the website maintainers and merged if they improve the website. For substantial changes it is best to reach out to the team by raising a GH issue for discussion first.