Migrated to: https://github.com/notifly-tech/notifly-docs
This repo contains the website configuration and documentation powering the Notifly Documentation.
- Git.
- Node (version 20 or greater).
- A fork of the repo (for any contributions).
- A clone of the
notifly-docsrepo.
- Run
npm installto install the website's workspace dependencies.
npm run write-translations -- --locale koto generate translations for Korean language.npm run startto start the development server (powered by Docusaurus).npm run start -- --locale koto start the server in Korean.
- Open http://localhost:3000/ site in your favorite browser.
- NOTE: Each locale is a distinct standalone single-page application: it is not possible to start the Docusaurus sites in all locales at the same time.
The following is a high-level overview of relevant files and folders. Sidebar automatically detects the directory structure.
└── /docs # default, english
├── client-sdk
├── http-api
└── intro.md
└── /i18n/ko # korean translation
└── docusaurus-plugin-content-docs/current # translation data the docs plugin needs
│ └── current
│ ├── client-sdk
│ ├── http-api
│ └── intro.md
└── ...
git checkout mainfrom any folder in your localnotifly-docsrepository.git pull origin mainto ensure you have the latest main code.git checkout -b the-name-of-my-branchto create a branch.
- Follow the "Running locally" instructions.
- Save the files and check in the browser.
- Some changes may require a server restart to generate new files. (Pages in
docsalways do!)
If possible, test any visual changes in all latest versions of the following browsers:
- Chrome and Firefox on the desktop.
- Chrome and Safari on mobile.
- Run
npm run formatto ensure your changes are consistent with other files in the repo. git add -A && git commit -m "feat: My message"to stage and commit your changes.- replace
My messagewith a commit message, such asFixed header logo on Android - Follow the rules of Conventional Commits
- replace
git push my-fork-name the-name-of-my-branch- Go to the notifly-docs repo and you should see recently pushed branches.
- Follow GitHub's instructions.
- Describe briefly your changes (in case of visual changes, please include screenshots).