HathorNetwork / HathorNetwork/hathor-core

Define standard for docstring

Open
#1 4 comments 0 reactions 0 assignees View on GitHub
documentation enhancement
Dominant language
Python
Stars
92
Forks
45
PR merge metrics
No merged PRs in 30d

Description

We've been using some different spacing/line-breaks for docstrings.

We need to define:
1. Should we have a space after the initial `"""`?
2. Do we ident the all lines to match the first line?

Some examples:
![image](https://user-images.githubusercontent.com/3236756/64601073-292e8780-d3b4-11e9-96b5-a2929eb32506.png)

![image](https://user-images.githubusercontent.com/3236756/64601089-3186c280-d3b4-11e9-9f87-43c905938ecd.png)

![image](https://user-images.githubusercontent.com/3236756/64601116-3ea3b180-d3b4-11e9-9f47-1a38dfc94896.png)

![image](https://user-images.githubusercontent.com/3236756/64601254-84f91080-d3b4-11e9-8501-b00a6110be1f.png)

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing the four docstring examples in the issue and comparing them with existing Python docstrings in the repository. Done means the project has one agreed convention covering spacing after the opening triple quotes and indentation of subsequent lines, with that convention documented for future contributors.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.