Skip to content

Feature/update readme#11

Merged
ncdulo merged 2 commits intomasterfrom
feature/update_readme
Feb 11, 2020
Merged

Feature/update readme#11
ncdulo merged 2 commits intomasterfrom
feature/update_readme

Conversation

@ncdulo
Copy link
Owner

@ncdulo ncdulo commented Feb 11, 2020

Beginning to undertake a larger overall re-write of README.md. I've decided to keep the work in a running feature branch so that I can swap back to working in other areas as need be. Due to the fact that the readme is a forward-facing part of this project, I am going to continually merge it into master after a visual check on GitHub.

The full re-write should not take a huge amount of time. I would like to work on it without rushing, and have quicker results, while not cluttering the master branch.

Will the PR stay the same, or will I need to make new ones? We shall soon find out.

Edit: This PR is in response to Issue #9

Added a brief notice elaborating on the reference to this project and
kratom. Also added a listing of the required Python package versions as
per `requirements.txt`. Giving visitors an easy overview of the
requirements is a nice thing to do.
Wrote up some basic installation instructions covering how to install
and run as well as venv creation and `requirements.txt` use. I feel that
should be fairly comprehensive for most uses. No idea how well they
translate to operating systems other than Linux, I will need to look
into that.

In the future, we may want to elaborate this a bit more. Add a few
sentences between each block of commands to explain what is going on.
Some users may not want or need a venv, for example. A  more verbose
instruction may prevent issue for some.
@ncdulo ncdulo added documentation Improvements or additions to documentation enhancement New feature or request labels Feb 11, 2020
@ncdulo ncdulo self-assigned this Feb 11, 2020
@ncdulo ncdulo merged commit 9c11877 into master Feb 11, 2020
@ncdulo ncdulo mentioned this pull request Feb 11, 2020
7 tasks
@ncdulo ncdulo linked an issue Feb 11, 2020 that may be closed by this pull request
7 tasks
@ncdulo ncdulo mentioned this pull request Feb 11, 2020
@ncdulo ncdulo deleted the feature/update_readme branch February 12, 2020 02:27
@ncdulo
Copy link
Owner Author

ncdulo commented Feb 12, 2020

Leaving a note regarding the branch deletion.. I can reuse the same name in the future, that was why I originally kept the branch. To continue work on this issue maintaining the same PR. However, I will have issues trying to push this branch to the future if I re-create it using the same name due to origin references.

The solution is when creating the next feature branch to work on this -- use a different one. Use feature/update_readme2 or something instead. It'll be great. 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Re-write README.md

1 participant