Create v0.19.0

versioned_docs/version-v0.19.0/cg/_category_.json

@@ -0,0 +1,5 @@
+{
+  "label": "Contribution & Feedback",
+  "position": 10,
+  "collapsed": true
+}

versioned_docs/version-v0.19.0/cg/bug-report.md

@@ -0,0 +1,57 @@
+# Filing a bug report
+
+Bug reports are critical to the rapid development of Obol. In order to make the process quick and efficient for all parties, it is best to follow some common reporting etiquette when filing to avoid double issues or miscommunications.
+
+## Checking if your issue exists
+
+Duplicate tickets are a hindrance to the development process and, as such, it is crucial to first check through Charon's existing issues to see if what you are experiencing has already been indexed.
+
+To do so, head over to the [issue page](https://github.com/ObolNetwork/charon/issues) and enter some related keywords into the search bar. This may include a sample from the output or specific components it affects.
+
+If searches have shown the issue in question has not been reported yet, feel free to open up a new issue ticket.
+
+## Writing quality bug reports
+
+A good bug report is structured to help the developers and contributors visualize the issue in the clearest way possible. It's important to be concise and use comprehensive language, while also providing all relevant information on-hand. Use short and accurate sentences without any unnecessary additions, and include all existing specifications with a list of steps to reproduce the expected problem. Issues that cannot be reproduced **cannot be solved**.
+
+If you are experiencing multiple issues, it is best to open each as a separate ticket. This allows them to be closed individually as they are resolved.
+
+An original bug report will very likely be preserved and used as a record and sounding board for users that have similar experiences in the future. Because of this, it is a great service to the community to ensure that reports meet these standards and follow the template closely.
+
+
+## The bug report template
+
+Below is the standard bug report template used by all of Obol's official repositories.
+
+```sh
+<!--- Provide a general summary of the issue in the Title above -->
+
+## Expected Behavior
+<!--- What should be happening? -->
+
+## Current Behavior
+<!--- What happens instead? -->
+
+## Steps to Reproduce
+<!--- Provide a concise set of steps to reproduce this bug.  -->
+1.
+2.
+3.
+4.
+5.
+
+## Detailed Description
+<!--- Provide some context for the issue you are experiencing. -->
+
+## Specifications
+<!--- Provide some information regarding your local system. --->
+Operating system:
+Version(s) used:
+
+## Possible Solution
+<!--- (Optional) Suggest a fix, reason or implementation for the bug. -->
+
+## Further Information
+<!--- Anything else to add?
+```
+

versioned_docs/version-v0.19.0/cg/docs.md

@@ -0,0 +1,248 @@
+# Documentation standards
+
+This section outlines the formatting standards presented within this documentation. In order to maintain continuity and quality, all pull requests must best conform to the specifics below.
+
+## Content types
+
+Walkthroughs and conceptual articles explained.
+
+### Walkthroughs
+
+The purpose of a walkthrough is to tell the user _how_ to do something. They do not need to convince the reader of something or explain a concept. Walkthroughs are a list of steps the reader must follow to achieve a process or function.
+
+The vast majority of documentation within this manual falls under the _Walkthrough_ category. Walkthroughs are generally quite short, have a neutral tone, and teach the reader how to achieve a particular process or function. They present the reader with concrete steps on where to go, what to type, and things they should click on. There is little to no _conceptual_ information within walkthroughs.
+
+#### Function or process
+
+The end goal of a walkthrough is for the reader to achieve a very particular function. 
+
+Take an installation page for example: Following this walkthrough isn't going to teach the reader much about working with the decentralized web or what Obol is. Still, by the end, they'll have Charon installed on their computer.
+
+#### Short length
+
+Since walkthroughs cover one particular function or process, they tend to be quite short. The estimated reading time of a walkthrough is somewhere between 2 and 10 minutes. Most of the time, the most critical content in a walkthrough is presented in a numbered list. Images and gifs can help the reader understand what they should be doing.
+
+If a walkthrough is converted into a video, that video should be no longer than 5 minutes.
+
+#### Walkthrough structure
+
+Walkthroughs are split into three major sections:
+
+1. Context to the topics covered.
+2. What we're about to do.
+3. The steps we need to do.
+4. Summary of what we just did, and potential next steps.
+
+### Conceptual articles
+
+Articles are written with the intent to inform and explain something. These articles don't contain any steps or actions that the reader has to perform _right now_.
+
+These articles are vastly different in tone when compared to walkthroughs. Some topics and concepts can be challenging to understand, so creative writing and interesting diagrams are highly sought-after for these articles. Whatever writers can do to make a subject more understandable, the better.
+
+#### Article goals
+
+Use the following goals when writing conceptual articles:
+
+| Goal | Keyword | Explanation |
+| ------------- | ------------------------ | -------------------------------------------------------------------------------- |
+| **Audience**  | _Knowledgeable_          | Requires a certain amount of focus to understand.                                |
+| **Formality** | _Neutral_                | Slang is restricted. **No you / your** -- explain informatively.                   |
+| **Domain**    | _Any_                    | Usually _technical_, but depends on the article.                                 |
+| **Tone**      | _Confident and friendly_ | The reader must feel confident that the writer knows what they're talking about. |
+| **Intent**    | _Describe_               | Tell the reader _why_ something does the thing that it does, or why it exists.   |
+
+#### Article structure
+
+Articles are separated into five major sections:
+
+1. Introduction to the thing we're about to explain.
+2. What the thing is.
+3. Why it's essential.
+4. What other topics it relates to.
+5. Summary review of what we just read.
+
+When designing a tutorial, keep in mind the walkthroughs and articles that already exist, and note down any additional content items that would need to be completed before creating the tutorial.
+
+# Grammar, formatting, and style
+
+Here are some language-specific rules that the Obol documentation follows. If you use a writing service like [Grammarly](https://www.grammarly.com/), most of these rules are turned on by default.
+
+### American English
+
+The Obol documentation portal is written in American English. 
+
+### The Oxford comma
+
+Follow each list of three or more items with a comma `,`:
+
+| Use                           | Don't use                    |
+| ----------------------------- | ---------------------------- |
+| One, two, three, and four.    | One, two, three and four.    |
+| Henry, Elizabeth, and George. | Henry, Elizabeth and George. |
+
+### Acronyms
+
+If you have to use an acronym, spell the full phrase first and include the acronym in parentheses `()` the first time it is used in each document. Exception: This generally isn't necessary for commonly-encountered acronyms like _EVM_, unless writing for a stand-alone article that may not be presented alongside project documentation.
+
+> Virtual Machine (VM), Decentralized Web (DWeb).
+
+## Formatting
+
+How the Markdown syntax looks, and code formatting rules to follow.
+
+## Style
+
+The following rules explain how we organize and structure our writing. The rules outlined here are in addition to the [rules](https://github.com/DavidAnson/markdownlint/blob/master/doc/Rules.md) found within the [Markdownlinter extension](https://github.com/DavidAnson/vscode-markdownlint).
+
+### Text
+
+The following rules apply to editing and styling text.
+
+#### Titles
+
+1. All titles follow sentence structure. Only _names_ and _places_ are capitalized, along with the first letter of the title. All other letters are lower-case:
+
+   ```markdown
+   ## This is a title
+
+   ### Only capitalize names and places
+
+   #### The capital city of France is Paris
+   ```
+
+2. Every article starts with a _front-matter_ title and description:
+
+   ```markdown
+   ---
+   title: Example article
+   description: This is a brief description that shows up in link teasers in services like Twitter and Slack.
+   ---
+
+   ## This is a subtitle
+
+   Example body text.
+   ```
+
+   In the above example `title:` serves as a `<h1>` or `#` tag. There is only ever one title of this level in each article.
+
+3. Titles do not contain punctuation. If you have a question within your title, rephrase it as a statement:
+
+   ```markdown
+   <!-- This title is wrong. -->
+
+   ## What is Charon?
+
+   <!-- This title is better. -->
+
+   ## Charon explained
+   ```
+
+#### Bold text
+
+Double asterisks `**` are used to define **boldface** text. Use bold text when the reader must interact with something displayed as text: buttons, hyperlinks, images with text in them, window names, and icons.
+
+```markdown
+In the **Login** window, enter your email into the **Username** field and click **Sign in**.
+```
+
+#### Italics
+
+Underscores `_` are used to define _italic_ text. Style the names of things in italics, except input fields or buttons:
+
+```markdown
+Here are some American things:
+
+- The _Spirit of St Louis_.
+- The _White House_.
+- The United States _Declaration of Independence_.
+
+```
+
+Quotes or sections of quoted text are styled in italics and surrounded by double quotes `"`:
+
+```markdown
+In the wise words of Winnie the Pooh _"People say nothing is impossible, but I do nothing every day."_
+```
+
+#### Code blocks
+
+Tag code blocks with the syntax of the core they are presenting:
+
+````markdown
+    ```javascript
+    console.log(error);
+    ```
+````
+
+#### List items
+
+All list items follow sentence structure. Only _names_ and _places_ are capitalized, along with the first letter of the list item. All other letters are lowercase:
+
+1. Never leave Nottingham without a sandwich.
+2. Brian May played guitar for Queen.
+3. Oranges.
+
+List items end with a period `.`, or a colon `:` if the list item has a sub-list:
+
+1. Charles Dickens novels:
+   1. Oliver Twist.
+   2. Nicholas Nickelby.
+   3. David Copperfield.
+2. J.R.R Tolkien non-fiction books:
+   1. The Hobbit.
+   2. Silmarillion.
+   3. Letters from Father Christmas.
+
+##### Unordered lists
+
+Use the dash character `-` for un-numbered list items:
+
+```markdown
+- An apple.
+- Three oranges.
+- As many lemons as you can carry.
+- Half a lime.
+```
+
+#### Special characters
+
+Whenever possible, spell out the name of the special character, followed by an example of the character itself within a code block.
+
+```markdown
+Use the dollar sign `$` to enter debug-mode.
+```
+
+#### Keyboard shortcuts
+
+When instructing the reader to use a keyboard shortcut, surround individual keys in code tags:
+
+```bash
+Press `ctrl` + `c` to copy the highlighted text.
+```
+
+The plus symbol `+` stays outside of the code tags.
+
+### Images
+
+The following rules and guidelines define how to use and store images.
+
+#### Storage location
+
+All images must be placed in the `/static/img` folder. For multiple images attributed to a single topic, a new folder within `/img/` may be needed.
+
+#### File names
+
+All file names are lower-case with dashes `-` between words, including image files:
+
+```text
+concepts/
+├── content-addressed-data.md
+├── images
+│   └── proof-of-spacetime
+│       └── post-diagram.png
+└── proof-of-replication.md
+└── proof-of-spacetime.md
+```
+
+_The framework and some information for this was forked from the original found on the [Filecoin documentation portal](https://docs.filecoin.io)_
+

versioned_docs/version-v0.19.0/cg/feedback.md

@@ -0,0 +1,5 @@
+# Feedback
+
+If you have followed our quickstart guides, and whether you succeeded or failed at running the distributed validator successfully, we would like to hear your feedback on the process and where you encountered difficulties. 
+- Please let us know by joining and posting on our [Discord](https://discord.gg/n6ebKsX46w). 
+- Also, feel free to add issues to our [GitHub repos](https://github.com/ObolNetwork).

versioned_docs/version-v0.19.0/charon/_category_.json

@@ -0,0 +1,5 @@
+{
+  "label": "Charon",
+  "position": 3,
+  "collapsed": false
+}