Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/develop'
Browse files Browse the repository at this point in the history
  • Loading branch information
suvajit-sarkar committed Dec 4, 2023
2 parents 6af6e59 + ddfaeda commit 7313ebb
Show file tree
Hide file tree
Showing 69 changed files with 780 additions and 293 deletions.
24 changes: 24 additions & 0 deletions .github/.spellcheck.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
matrix:
- name: Markdown
expect_match: false
apsell:
mode: en
dictionary:
wordlists:
- .github/.wordlist.txt
output: wordlist.dic
encoding: utf-8
pipeline:
- pyspelling.filters.markdown:
markdown_extensions:
- markdown.extensions.extra:
- pyspelling.filters.html:
comments: false
attributes:
- alt
ignores:
- ':matches(code, pre, .photoAuthor)'
- 'code'
- 'pre'
- 'blockquote'
171 changes: 171 additions & 0 deletions .github/.wordlist.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,171 @@
Hyperledger
Corda
Ansible
DLT
DevOps
reStructuredText
Kubernetes
Github
TSC
mwagner
redhat
zyz
Alagbe
Cepeda
Deepak
Gómez
Jagpreet
Kumar
Picazo
Sarkar
Sasan
Suvajit
sownak
Opensource
Besu
ReadTheDocs
boolean
Codecov
tkuhrt
hamilton
jonathan
DCI
runtime
Tessera
IBFT
CII
rst
toctree
conf
py
md
pre
html
http
www
rst
toctree
reStructuredText
DCO
UI
Blockchain
DigitalOcean
GCP
repo
APIs
readme
https
EKS
yaml
microservices
Modularity
Scalability
readthedocs
roadmap
Jira
CLI
ansible
kubectl
gitops
CRD
CustomResourceDefinition
fluxcd
github
TBD
trainings
HashiCorp
upto
HelmRelease
hackathon
Hashicorp
Authenticator
JSON
ajv
cli
npm
NPM
MacOS
jq
openshift
Homebrew
validator
blockchain
GitOps
VM
backend
DNS
HAProxy
POC
dev
url
cryptographically
BaaS
OpenShift
BYOI
architected
TCP
scalable
MSP
SDK
MSPs
kubeconfig
TLS
PV
RPC
CorDapps
JVM
CA’s
PKI
KUBECONFIG
DDO
DIDs
NYM
rpc
MTA
memcached
auditable
config
IAM
IOT
IoT
kubelet
Kubeconfig
PersistentVolume
lifecycle
cryptographic
decrypting
SCM
SHA
Brandl
Georg
LDAP
Chaincode
chaincode
subnet
Orderer
permissioned
Zkkafka
zkkafka
servlet
CA’s
NetworkMap
Networkmap
interoperable
merkle
Verinym
Sovrin
Prover
Anonym
DKMS
Enode
privateFor
Ethereum
geth
pluggable
Hostnames
crypto
parallelization
kube
PV's
CorDapp
storageclass
73 changes: 73 additions & 0 deletions .github/workflows/grammarcheck.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
name: grammer check
on:
workflow_dispatch:
inputs:
grammar_check_disabled:
description: 'Disable grammar check'
default: 'false'
required: false
push:
branches:
- "**"
pull_request:
paths:
- 'docs/*.md'
types: [opened, edited, updated]

env:
GRAMMAR_CHECK_DISABLED: ${{ github.event.inputs.grammar_check_disabled || 'false' }}

jobs:
check-grammar:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Set up Python 3.8
uses: actions/setup-python@v2
with:
python-version: 3.8
# Install the dependencies for grammer check
- name: Install dependencies
run: |
python -m pip install --upgrade pip setuptools
pip install --user --upgrade language_tool_python
# To check the grammatical mistakes of the given files and folders.
- name: Run grammar check
if: ${{ env.GRAMMAR_CHECK_DISABLED == 'false' }}
run: |
python - <<EOF
import language_tool_python
# Initialize LanguageTool
tool = language_tool_python.LanguageTool('en-US') # You can specify the language you want to check.
# Specify the directory path
directory_path = 'docs'
# Read the text from your file
file_path = 'docs/*.md' # Update the path accordingly
with open(file_path, 'r', encoding='utf-8') as file:
text = file.read()
# Check for grammar errors
matches = tool.check(text)
# Print relevant grammar errors with line numbers
relevant_errors = []
if matches:
for match in matches:
if match.ruleId == 'MORFOLOGIK_RULE_EN_US':
line_number = text.count('\n', 0, match.offset) + 1
relevant_errors.append((line_number, match.message))
if relevant_errors:
for error in relevant_errors:
line_number, message = error
print(f"Grammar error at line {line_number}: {message}")
exit(1)
else:
print("No grammar errors found.")
exit(0)
EOF
38 changes: 38 additions & 0 deletions .github/workflows/spellcheck.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
name: spell check
on:
push:
branches:
- "**"
pull_request:
paths:
- 'docs/*.md'
types: [opened, edited, updated]

env:
SPELL_CHECK_DISABLED: false

jobs:
check-spelling:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Set up Python 3.8
uses: actions/setup-python@v2
with:
python-version: 3.8
# Install the dependencies for spell check.
- name: Install dependencies
run: |
python -m pip install --upgrade pip setuptools
python -m pip install pyspelling
sudo apt-get install hunspell hunspell-en-us aspell aspell-en
- uses: actions/checkout@v2
- name: Spellcheck
if: ${{ env.SPELL_CHECK_DISABLED == 'false' }}
uses: rojopolis/[email protected]
with:
config_path: .github/.spellcheck.yaml
source_files: 'docs/*.md' # name of the file to check the spell
task_name: Markdown
1 change: 1 addition & 0 deletions .github/workflows/test_networkschema.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ jobs:
- name: Install dependencies
run: |
# install npm and ajv-cli
sudo apt-get update
sudo apt-get install npm
npm install -g ajv-cli
# export the bin path
Expand Down
35 changes: 16 additions & 19 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -1,41 +1,38 @@
# Docs
## About
This directory contains the files required to create open source documentation.
Tools used: [Sphinx](http://www.sphinx-doc.org/)
### Configuration files
* **Index.rst** - This is the main document. Main function of this document is to serve as a welcome page, and to contain the root of the “table of contents tree” (or toctree).This is one of the main things that Sphinx adds to reStructuredText, a way to connect multiple files to a single hierarchy of documents
* **conf.py** - The configuration directory must contain a file named conf.py. This file (containing Python code) is called the “build configuration file” and contains (almost) all configuration needed to customize Sphinx input and output behavior.
* **.md files** - Create all the markdown file which are referenced in the document tree with the appropriate content.
This directory contains the files required to create open-source documentation.
Tools used: [Sphinx] (http://www.sphinx-doc.org/).
## Configuration files
* **index.rst** - This is the main document. This is one of the main things that Sphinx adds to restructured text: a way to connect multiple files to a single hierarchy of documents, including the 'table of contents tree'(or toctree).
* **conf.py**: The configuration directory must contain a file named conf.py. This file (containing Python code) is called the “build configuration file” and contains (almost) all the configuration needed to customize Sphinx input and output behavior.
* **.md files**: Create all the markdown files that are referenced in the document tree with the appropriate content.

```
./
├── docs
│   ├── source
── index.rst
├── conf.py
├── *.md
| | |── index.rst
  │   ├── conf.py
  │   ├── *.md
│   ├── Makefile
| ├── pip-requirements.txt
|   ├── pip-requirements.txt
│   └── README.md
├── CONTRIBUTING.md
```

### Building the docs
1. Install latest sphinx
1. Install the latest Sphinx.
```
pip install -U Sphinx
```
2. Install the pre-requisites
2. Install the prerequisites.
```
pip install -r pip-requirements.txt
```
3. Build the documents
3. Build the documents.
```
make html
make HTML
or
make.bat html
make.bat HTML
```
4. Access the documents from **build/html/** folder.



4. Access the documents from the **build/html** folder.
2 changes: 1 addition & 1 deletion docs/source/compatibilitytable.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

# Compatibility Table
Bevel current tools/platforms support version and historic details
## Colour Legends
## Color Legends
![](./_static/legends.png)
## Compatibility Table
![](./_static/compatibility_table.png)
Loading

0 comments on commit 7313ebb

Please sign in to comment.