> This post was originally posted [here](https://dev.to/nicoh/sdoc-a-simple-documentation-tool-a64)

I'm building a simple doc tool for inline commentaries, with markdown support. The project started as a need to have a simple documentation tool for documenting reusable components.

> Installation

`npm install @nhevia/simple-docs`


or install as a development dependency:

`npm install --save-dev @nhevia/simple-docs`

> Usage

- Add `sdoc` as a package.json script:

```json
"scripts": {
  "docs": "sdoc"
}
```

- Use a comment block at the start of any file with `sdoc` preffix:

```javascript
/*sdoc
This is the main component
*/

// your code
```

- Run `npm run docs`. It will indentify documentation blocks in your project and generates an output file (`sdoc.md` by default, on root folder):


Since the generated file is markdown, it is supported inside documentation blocks.

```javascript
/*sdoc
  This is the **main** component
*/
```

![image](https://user-images.githubusercontent.com/50466554/91442173-b727aa80-e871-11ea-9a97-b54b94d9d72a.png)

There is more info (examples, options, etc) in the [repository's readme](https://github.com/nhevia/simple-docs#readme)


This is my first public package and I got some help from a couple awesome people, but the project is totally open for PRs, enhancement, fixes, documentation, you call it.

I'm posting this hoping someone might find it useful or want to improve it a little bit. I don't intend this to be super serious because there are awesome documentation tools with lot of support, but it surely is a fun way to spend some time.


The simplest documentation tool you've ever seen.

sdoc - A simple documentation tool

> This post was originally posted [here](https://dev.to/nicoh/installing-oh-my-zsh-on-ubuntu-362f)

ZSH (or Z Shell), is an extended version of the default shell. It includes new features, themes and plugins.

We can install it from the default shell using:

```bash
apt install zsh
```

[Oh-my-zsh](https://ohmyz.sh/) is a framework that runs on top of ZSH. If you want to understand it from a web example, it would be something like this: ZSH is Javascript and oh-my-zsh is React/Angular/Vue/etc.

From their site: 

>Oh My Zsh is a delightful, open source, community-driven framework for managing your Zsh configuration. It comes bundled with thousands of helpful functions, helpers, plugins, themes, and a few things (...)


We can simply install it with a one-liner. Via cURL:

```bash
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
```

Or via Wget:

```bash
sh -c "$(wget https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh -O -)"
```

We accept changing our default shell to zsh, enter our password and that's it:

![installation_completed](https://i.imgur.com/EombiMZ.png)

Note: As you can see, the ~ symbol indicates that zsh is being used. But if we close the terminal and open it again, the default shell will be used.

We can now run '$ zsh' to enable it, or simply logout/login and the default shell will be zsh.

If the change didn't work and we still have the default shell running, run:

```bash
sudo chsh -s $(which zsh) $(whoami)
```

## Customization

ohmyzsh comes with a lot of plugins and themes preinstalled. I'll be showing you how to customize it using my current preset.

First, we install powerline font to have support for icons in our terminal:

```bash
sudo apt install fonts-powerline
```

Then, we change the default theme 'robbyrussell' to [agnoster](https://github.com/agnoster/agnoster-zsh-theme). This one is pretty common because it's optimized for git repository usage.

```bash
sudo nano ~/.zshrc
```
And change ZSH_THEME variable to ZSH_THEME="agnoster".

To remove the username and host from the prompt, modify:

```bash
sudo nano ~/.oh-my-zsh/themes/agnoster.zsh-theme
```

And comment 'prompt_context' like below:

![comment_prompt_context](https://i.imgur.com/XUA6YSX.png)

If you followed the previous steps, you'd have something like this (using Solarized Dark theme for the terminal): 

![final](https://i.imgur.com/gtYtZuJ.png)