mirror of
https://github.com/silverstripe/doc.silverstripe.org
synced 2024-10-22 15:05:50 +00:00
MNT Consume dev docs from the new developer-docs repo (#243)
This commit is contained in:
parent
415351f12e
commit
a7426b66c4
31
README.md
31
README.md
@ -8,17 +8,17 @@ developer documentation website](https://docs.silverstripe.org) and
|
|||||||
|
|
||||||
This application is build on [Gatsby](https://gatsbyjs.com), a static
|
This application is build on [Gatsby](https://gatsbyjs.com), a static
|
||||||
site generator based on [React](https://reactjs.org). It sources content
|
site generator based on [React](https://reactjs.org). It sources content
|
||||||
from the [framework](https://github.com/silverstripe/silverstripe-framework)
|
from the [silverstripe/developer-docs](https://github.com/silverstripe/developer-docs)
|
||||||
repository for each major release.
|
repository for each major release.
|
||||||
|
|
||||||
**This repository does NOT contain any documentation.**
|
**This repository does NOT contain any documentation.**
|
||||||
|
|
||||||
The developer documentation is stored in the framework module
|
The developer documentation is stored in the [silverstripe/developer-docs repository](https://github.com/silverstripe/developer-docs)),
|
||||||
repository, in the `docs` folder. For example, the documentation for the
|
in the `en` folder. For example, the documentation for the
|
||||||
master branch of Silverstripe CMS is stored in
|
Silverstripe CMS 4.x is stored in
|
||||||
[https://github.com/silverstripe/silverstripe-framework/tree/master/docs](https://github.com/silverstripe/silverstripe-framework/tree/master/docs).
|
[https://github.com/silverstripe/developer-docs/tree/4/en](https://github.com/silverstripe/developer-docs/tree/4/en).
|
||||||
|
|
||||||
The userhelp documentation is stored in the [userhelp-content repo](https://github.com/silverstripe/silverstripe-userhelp-content/).
|
The userhelp documentation is stored in the [silverstripe/silverstripe-userhelp-content repo](https://github.com/silverstripe/silverstripe-userhelp-content/).
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
@ -33,10 +33,10 @@ To set up a local instance of [doc.silverstripe.org](https://github.com/silverst
|
|||||||
|
|
||||||
No local NodeJS nor gatsby-cli is required for this option.
|
No local NodeJS nor gatsby-cli is required for this option.
|
||||||
|
|
||||||
* Make sure docker and docker-compose are installed and docker daemon is running
|
* Make sure docker and docker-compose are installed and docker daemon is running
|
||||||
* Simply use `./docker/run` to run gatsby commands
|
* Simply use `./docker/run` to run gatsby commands
|
||||||
- `./docker/run build` would be equal to run `gatsby build` within a container
|
* `./docker/run build` would be equal to run `gatsby build` within a container
|
||||||
- `./docker/run develop -p 8000` would run `gatsby develop -p 8000` within a container.
|
* `./docker/run develop -p 8000` would run `gatsby develop -p 8000` within a container.
|
||||||
|
|
||||||
### Native install
|
### Native install
|
||||||
|
|
||||||
@ -83,9 +83,9 @@ yarn build-user
|
|||||||
## Authoring
|
## Authoring
|
||||||
|
|
||||||
You can make changes directly to the source markdown files and get live updates in the development
|
You can make changes directly to the source markdown files and get live updates in the development
|
||||||
server without having to rebuild the app or even refresh the browser. The clones of the `silverstripe/framework`
|
server without having to rebuild the app or even refresh the browser. The clones of the `silverstripe/developer-docs`
|
||||||
repositories are in the `.cache/gatsby-source-git` folder in the root of this project. There are subfolders
|
repositories are in the `.cache/gatsby-source-git` folder in the root of this project. There are subfolders
|
||||||
for `3/` and `4/`, respective to their branch names. You can edit the files in `docs/en` from there.
|
for `3/` and `4/`, respective to their branch names. You can edit the files in `en` from there.
|
||||||
|
|
||||||
Just don't forget to merge your changes upstream once you're done. Building the gatsby app will not preserve
|
Just don't forget to merge your changes upstream once you're done. Building the gatsby app will not preserve
|
||||||
your content changes, since the remote repositories are the source of truth.
|
your content changes, since the remote repositories are the source of truth.
|
||||||
@ -93,7 +93,7 @@ your content changes, since the remote repositories are the source of truth.
|
|||||||
## Deploying content changes
|
## Deploying content changes
|
||||||
|
|
||||||
Once your contribution has been merged into the master branch, it will be deployed to production via a
|
Once your contribution has been merged into the master branch, it will be deployed to production via a
|
||||||
Github action in the repository that holds the markdown files (e.g. `silverstripe/silverstripe-framework` for docs).
|
Github action in the repository that holds the markdown files (e.g. `silverstripe/developer-docs` for developer docs).
|
||||||
|
|
||||||
## Deploying app changes
|
## Deploying app changes
|
||||||
|
|
||||||
@ -107,6 +107,5 @@ their way onto the https://docs.silverstripe.org or https://userhelp.silverstrip
|
|||||||
|
|
||||||
If you wish to edit the documentation content, submit a pull request
|
If you wish to edit the documentation content, submit a pull request
|
||||||
on the
|
on the
|
||||||
[framework Github project](https://github.com/silverstripe/silverstripe-framework) or the
|
[developer documentation](https://github.com/silverstripe/developer-docs) repository or the
|
||||||
[userhelp documentation](https://github.com/silverstripe/silverstripe-userhelp-content) repository
|
[userhelp documentation](https://github.com/silverstripe/silverstripe-userhelp-content) repository.
|
||||||
or corresponding module.
|
|
@ -48,7 +48,7 @@ exports.onCreateNode = async ({ node, getNode, getNodesByType, actions, createNo
|
|||||||
}
|
}
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
const basePath = category === 'user' ? `docs/en/userguide` : `docs/en`;
|
const basePath = category === 'user' ? `docs/en/userguide` : `en`;
|
||||||
const filePath = createFilePath({
|
const filePath = createFilePath({
|
||||||
node,
|
node,
|
||||||
getNode,
|
getNode,
|
||||||
|
@ -3,18 +3,18 @@ module.exports = [
|
|||||||
resolve: `gatsby-source-git`,
|
resolve: `gatsby-source-git`,
|
||||||
options: {
|
options: {
|
||||||
name: `docs--4`,
|
name: `docs--4`,
|
||||||
remote: `https://github.com/silverstripe/silverstripe-framework.git`,
|
remote: `https://github.com/silverstripe/developer-docs.git`,
|
||||||
branch: `4`,
|
branch: `4.11`,
|
||||||
patterns: `docs/en/**`
|
patterns: `en/**`
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
resolve: `gatsby-source-git`,
|
resolve: `gatsby-source-git`,
|
||||||
options: {
|
options: {
|
||||||
name: `docs--3`,
|
name: `docs--3`,
|
||||||
remote: `https://github.com/silverstripe/silverstripe-framework.git`,
|
remote: `https://github.com/silverstripe/developer-docs.git`,
|
||||||
branch: `3`,
|
branch: `3`,
|
||||||
patterns: `docs/en/**`
|
patterns: `en/**`
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
];
|
];
|
Loading…
x
Reference in New Issue
Block a user