-
Notifications
You must be signed in to change notification settings - Fork 83
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
(initial-commit)beta-docs: populate beta test repo with docs
Signed-off-by: ksatchit <[email protected]>
- Loading branch information
ksatchit
committed
Oct 26, 2020
0 parents
commit 728f8cf
Showing
463 changed files
with
115,235 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
*/node_modules | ||
*.log |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
# Lines starting with '#' are comments. | ||
# Each line is a file pattern followed by one or more owners. | ||
|
||
# These owners will be the default owners for everything in the repo. | ||
* @divya-mohan0209 @ksatchit @k8s-dev |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,27 @@ | ||
<!-- This form is for bug reports and feature requests ONLY! --> | ||
<!-- Thanks for filing an issue! Before hitting the button, please answer these questions.--> | ||
|
||
## Is this a BUG REPORT or FEATURE REQUEST? | ||
|
||
Choose one: BUG REPORT or FEATURE REQUEST | ||
|
||
<!-- | ||
If this is a BUG REPORT, please: | ||
- Fill in as much of the template below as you can. If you leave out information, we can't help you as well. | ||
If this is a FEATURE REQUEST, please: | ||
- Describe *in detail* the feature/behavior/change you'd like to see. | ||
In both cases, be ready for followup questions, and please respond in a timely | ||
manner. If we can't reproduce a bug or think a feature already exists, we | ||
might close your issue. If we're wrong, PLEASE feel free to reopen it and | ||
explain why. | ||
--> | ||
|
||
**What happened**: | ||
|
||
**What you expected to happen**: | ||
|
||
**How to reproduce it (as minimally and precisely as possible)**: | ||
|
||
**Anything else we need to know?**: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,12 @@ | ||
<!-- Thanks for sending a pull request! Here are some tips for you --> | ||
|
||
**What this PR does / why we need it**: | ||
|
||
**Which issue this PR fixes** *(optional, in `fixes #<issue number>(, fixes #<issue_number>, ...)` format, will close that issue when PR gets merged)*: fixes # | ||
|
||
**Special notes for your reviewer**: | ||
|
||
**Checklist:** | ||
- [ ] Fixes #<issue number> | ||
- [ ] Signed the commit for DCO to be passed | ||
- [ ] Labelled this PR & related issue with `documentation` tag |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,46 @@ | ||
name: LitmusDocs-CI | ||
on: | ||
pull_request: | ||
types: [ opened, synchronize, reopened ] | ||
|
||
jobs: | ||
embedmd: | ||
runs-on: ubuntu-latest | ||
steps: | ||
|
||
- uses: actions/checkout@v2 | ||
with: | ||
ref: ${{steps.getcommit.outputs.sha}} | ||
|
||
- uses: actions/setup-go@v2 | ||
with: | ||
stable: 'false' | ||
go-version: '1.14.0' | ||
|
||
- name: Installing and Running embedmed | ||
run: | | ||
sudo apt install boxes | ||
go get github.com/campoy/embedmd | ||
cd docs | ||
embedmd -w $(find *.md) | ||
continue-on-error: true | ||
|
||
- name: embedmd check | ||
run: | | ||
export TERM=xterm-256color | ||
count=$(git status -s| wc -l) | ||
if [ "$count" -ne "0" ] | ||
then | ||
tput setaf 1; echo "Error: embedmd check failed" | ||
tput setaf 4; echo "Please check the following files need an embedmd run:" | ||
output=$(git status -s) | ||
echo "$output" | boxes -d stone -p a2v1 | ||
tput setaf 3; echo "Please follow the instructions to run embedmd:" | ||
tput setaf 3; echo "cd docs" | ||
tput setaf 3; echo "embedmd -w \$(find *.md)" | ||
tput setaf 6; echo "For more info visit https://github.com/litmuschaos/litmus-docs/blob/master/CONTRIBUTING.md" | ||
exit 1 | ||
else | ||
tput setaf 2; echo "Nothing to embed" | ||
fi | ||
shell: sh |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,16 @@ | ||
.DS_Store | ||
.idea/ | ||
node_modules | ||
package-lock.json | ||
|
||
lib/core/metadata.js | ||
lib/core/MetadataBlog.js | ||
|
||
docs/embedmd-command.sh | ||
|
||
website/translated_docs | ||
website/build/ | ||
website/yarn.lock | ||
website/node_modules | ||
website/i18n/* | ||
*.log |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,88 @@ | ||
# Contributing to Litmus Documentation | ||
|
||
Welcome to Litmus!! This guide goes over in details about the contribution process to the documentation. | ||
|
||
Litmus is an Apache 2.0 Licensed project and uses the standard GitHub pull requests process to review and accept contributions. We welcome improvements from all contributors, new and experienced. | ||
|
||
Litmus documentation contributors: | ||
|
||
* Improve existing content | ||
* Create new content | ||
* Maintain documentation framework | ||
* Keep documentation builds healthy | ||
* Manage and publish documentation as part of the Litmus release cycle | ||
|
||
Contributions are not limited to the above mentioned items. In case you have ideas for improving the documentation - create a PR. | ||
|
||
|
||
## Steps to Contribute | ||
Litmus documentation currently runs using [Docusaurus](https://docusaurus.io/) static file generator. [Embedmd](https://github.com/campoy/embedmd/) for embedding source codes into the documentation. [Travis CI](https://travis-ci.com/) is the build tool. Also, we have integrated [Netlify](https://www.netlify.com/) to deploy preview of the change. | ||
|
||
* Find an issue to work on or create a new issue. The issues are maintained at [litmuschaos/litmus](https://github.com/litmuschaos/litmus/issues). For new contributors, you can pick up from a list of [good first issues](https://github.com/litmuschaos/litmus/issues?q=is%3Aissue+is%3Aopen+label%3Aarea%2Flitmus-docs+label%3A%22good+first+issue%22+) | ||
* Claim your issue by commenting your intent to work on it to avoid duplication of efforts. | ||
* Fork the repository on GitHub. | ||
* Create a branch from where you want to base your work (usually master). | ||
* Make your changes, test locally, see preview by starting server and seeing in Preview Mode. | ||
* Execute embedmd command before commiting your changes, so that it can embed source code into documentation, refer [README](/README.md) for steps. | ||
* Commit your changes by making sure the commit messages convey the need and notes about the commit. Also make sure to [sign your commit](https://github.com/litmuschaos/litmus-docs/blob/master/CONTRIBUTING.md#sign-your-work) while making a new commit. | ||
* Push your changes to the branch in your fork of the repository. | ||
* Submit a pull request to the original repository. | ||
|
||
A sample PR flow is outlined [here](https://guides.github.com/introduction/flow/). More detailed one is [here](https://gist.github.com/Chaser324/ce0505fbed06b947d962). | ||
|
||
## Use embedmd command before commiting changes | ||
|
||
- Once you're done with the changes don't forget to run `embedmd` which will extract the embedded code from different files. For this you need do: | ||
|
||
```bash | ||
cd docs | ||
embedmd -w $(find *.md) | ||
``` | ||
|
||
## Pull Request Checklist | ||
|
||
* Rebase to the current master branch before submitting your pull request. | ||
|
||
* Commits should be kept small if possible. Each commit should follow the checklist below: | ||
|
||
|
||
- Pass the compile and tests - includes spell checks, formatting, etc. | ||
- Commit header (first line) should convey what changed | ||
- Commit body should include details such as why the changes are required and how the proposed changes | ||
- View automated netlify preview link on your PR for correctness of your changes. Escalate to project maintainers if the netify preview fails. | ||
|
||
Protip : Refer to good PR etiquettes [here](https://gist.github.com/mikepea/863f63d6e37281e329f8). | ||
|
||
* If your PR is not getting reviewed or you need a specific person to review it, please reach out to the Litmus contributors at the [Litmus slack channel](https://app.slack.com/client/T09NY5SBT/CNXNB0ZTN) | ||
|
||
### Sign your work | ||
|
||
We use the Developer Certificate of Origin (DCO) as an additional safeguard for the LitmusChaos project. This is a well established and widely used mechanism to assure that contributors have confirmed their right to license their contribution under the project's license. Please add a line to every git commit message: | ||
|
||
``` | ||
Signed-off-by: Random J Developer <[email protected]> | ||
``` | ||
|
||
The email id should match the email id provided in your GitHub profile. | ||
|
||
If you set your `user.name` and `user.email` in git config, you can sign your commit automatically with `git commit -s`. | ||
|
||
You can also use git [aliases](https://git-scm.com/book/tr/v2/Git-Basics-Git-Aliases) like `git config --global alias.ci 'commit -s'`. Now you can commit with `git ci` and the commit will be signed. | ||
|
||
### Adhere to Documentation Standards | ||
|
||
Please ensure you follow the below standards around naming to avoid rework on the submitted pull requests. | ||
|
||
- Resource names like ChaosEngine, ChaosExperiment, ChaosResult etc. should be in PascalCase. | ||
- Spec attributes should be in camelCase. | ||
## Community | ||
|
||
We organize the Litmus into Special Interest Groups or SIGs in order to improve our workflow and to easily manage this community project. The developers within each SIG have autonomy and ownership over that SIG’s part of Litmus. | ||
|
||
Like everything else in Litmus, a SIG is an open, community, effort. We thrive on a lively and friendly open-source community. Anybody is welcome to jump into a SIG and begin fixing issues/documentation, critiquing design proposals and reviewing code. | ||
|
||
The Litmus community will have a weekly contributor sync-up on Mondays 20.30-21.30IST | ||
- The sync up meeting is held online on [zoom](https://zoom.us/j/91358162694) | ||
- The contribution items are tracked in this [planning sheet](https://docs.google.com/document/d/1Z9DrnA8W_IM2HnVOWU1dtVrVB9MyWj8VP43YS_A_wFs). | ||
|
||
SIG Documentation is [here](https://github.com/litmuschaos/litmus/wiki/Special-Interest-Groups#sig-documentation). Please join the weekly zoom call, introduce yourself and get started!! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
FROM node:8.11.4 AS build-env | ||
|
||
WORKDIR /app/website | ||
|
||
EXPOSE 3000 35729 | ||
COPY ./docs /app/docs | ||
COPY ./website /app/website | ||
RUN yarn install | ||
RUN yarn build | ||
CMD ["yarn", "start"] | ||
|
||
FROM nginx:1.13-alpine | ||
COPY --from=build-env /app/website/build/litmus/ /usr/share/nginx/html | ||
COPY ./nginx-custom.conf /etc/nginx/conf.d/default.conf | ||
EXPOSE 80 |
Oops, something went wrong.