Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Possible README installation instruction #8175

Merged
merged 5 commits into from
Mar 23, 2017

Conversation

kirrg001
Copy link
Contributor

@kirrg001 kirrg001 commented Mar 16, 2017

The installation steps in the README are not optimal right now.
I went over them and found some variants.

readme2
^ very short, npm run init wraps all necessary commands to install Ghost.

readme
^ we show people that they have to run knex-migrator init

readme1
^ we describe all commands

readme3

No matter which variant we take, i would like to create a wiki page to have some more detailed descriptions for installation, workflow, testing (e.g. how can a user reset it's database, how can a use run a single test etc). So the README could link to a wiki page with a full guide.

One thing to note
To be able to run grunt init, we have to install the Ghost dependencies.
This was tested with a fresh clone and zero global or local npm packages.

Copy link
Member

@ErisDS ErisDS left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I prefer option 3 - more verbose but also super clear.

Copy link
Member

@JohnONolan JohnONolan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also think option 3 seems best

- add contributing workflow link already
- i would suggest we merge this PR if the workflow guide was reviewed
@kirrg001 kirrg001 mentioned this pull request Mar 20, 2017
48 tasks
@ErisDS
Copy link
Member

ErisDS commented Mar 21, 2017

How come this is still WIP? Would like to merge 😁

@kirrg001
Copy link
Contributor Author

I played with the markdown formatting a bit, because i couldn't use colours in github markdown. I will update later and then we can merge.

@kirrg001
Copy link
Contributor Author

Pushed some final updates.
Take a look https://github.com/kirrg001/Ghost/tree/1.0.0-dev/update-readme to see the README version.

I have removed the information about the fork url. I think people should follow our git workflow and add their fork as remote stream. The git workflow is also linked in our working with ghost wiki. Tell me if you feel different.

@kirrg001 kirrg001 changed the title [WIP] Possible README installation instruction Possible README installation instruction Mar 22, 2017
@ErisDS ErisDS merged commit 76fd126 into TryGhost:master Mar 23, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants