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

Tutorial.rst: Change documentation about .coafile #510

Merged
merged 1 commit into from
Mar 10, 2018

Conversation

Rahmeen14
Copy link
Contributor

@Rahmeen14 Rahmeen14 commented Dec 16, 2017

Replaced the deprecated [Default] section by [cli]. Also, assigned True to use_spaces instead of yeah.
These changes were made because the previous documentation was inconsistent with the observation upon execution of coala.
Fixes coala/coala#4968

For short term contributors: we understand that getting your commits well
defined like we require is a hard task and takes some learning. If you
look to help without wanting to contribute long term there's no need
for you to learn this. Just drop us a message and we'll take care of brushing
up your stuff for merge!

Checklist

  • I read the commit guidelines and I've followed
    them.
  • I ran coala over my code locally. (All commits have to pass
    individually.
    It is not sufficient to have "fixup commits" on your PR,
    our bot will still report the issues for the previous commit.) You will
    likely receive a lot of bot comments and build failures if coala does not
    pass on every single commit!

After you submit your pull request, DO NOT click the 'Update Branch' button.
When asked for a rebase, consult coala.io/rebase
instead.

Please consider helping us by reviewing other peoples pull requests as well:

The more you review, the more your score will grow at coala.io and we will
review your PRs faster!

@Rahmeen14
Copy link
Contributor Author

Hi! I have tried to fix the issue coala/coala#4968 assigned to me. Could it be reviewed, please? This is my first attempt at a PR. I hope to learn a lot from here. Thanks!

Copy link

@ishanSrt ishanSrt left a comment

Choose a reason for hiding this comment

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

Its not a bug so use Closes instead of Fixes

@ishanSrt
Copy link

Use git commit --amend and then force push your changes

@ishanSrt
Copy link

Also the expected results says to use yeah but you have changed it to true

@ishanSrt
Copy link

ishanSrt commented Dec 17, 2017

unack e8c2d09

@Rahmeen14
Copy link
Contributor Author

@ishanSrt I'll change 'fixes' to 'Closes', thank you for pointing that out.
The edit however was intended to change the documentation so that it may conform to the actual result we obtain on opening the .coafile following the getting started guide rather the deprecated one which had been documented. The PR attempted to document the actual results, i.e, true instead of the deprecated yeah

@ishanSrt
Copy link

ishanSrt commented Dec 17, 2017

Great!

Copy link
Member

@RaiVaibhav RaiVaibhav left a comment

Choose a reason for hiding this comment

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

@Rahmeen14 replace true with True as per line 67 in https://github.com/coala/documentation/edit/master/Users/Tutorial.rst
we are passing True not true , also make a Note (because in many places they have given an example with the help of Default section , but if newcomer read all those he will get confused as he don't get what exactly is Default Section after current changes on your commit) of

Default section is now deprecated (--> its inheritance features),

@RaiVaibhav
Copy link
Member

@ishanSrt

Also the expected results says to use yeah but you have changed it to true

that is the expected results it depends what we passed , but on Tutorial we passed True :)

@Rahmeen14
Copy link
Contributor Author

Rahmeen14 commented Dec 17, 2017

@RaiVaibhav Thanks for the review. I'll make the changes! For the other statements about the default section, do I add the required note right in the beginning of the tutorial?

@RaiVaibhav
Copy link
Member

Imo in between line 159 and 161 will be better

@Rahmeen14
Copy link
Contributor Author

Will do it! Thank you once again! :)

@Rahmeen14
Copy link
Contributor Author

@RaiVaibhav I have made the desired changes, could you please review it once?
So sorry for bothering you again. Thanks for your time!

@ishanSrt
Copy link

wouldn't it be better to change all references of [Default] section to [cli] section than just referencing its depreciation?

@ishanSrt
Copy link

ishanSrt commented Dec 17, 2017

Anyways I would recommend making that Note bold and also mention that we are using [cli] instead of (--> its inheritance features)

@Rahmeen14
Copy link
Contributor Author

@ishanSrt I have followed the same format as goes for other notes in that .rst file. I don't think bolding it explicitly should be necessary.

@Makman2
Copy link
Member

Makman2 commented Jan 15, 2018

Could you remove the space before the colon in the shortlog? Also please describe the reason of this change in the commit body so somebody can immediately understand why this is done (due to inconsistencies).

@Makman2
Copy link
Member

Makman2 commented Jan 15, 2018

unack 01ccab0

@Rahmeen14 Rahmeen14 force-pushed the mybranch branch 2 times, most recently from 6ba1fa0 to fead2f5 Compare January 16, 2018 15:17
@Rahmeen14
Copy link
Contributor Author

Have made the required changes. @Makman2 I'm sorry for bothering you again but can you please review it?

@Rahmeen14 Rahmeen14 changed the title Tutorial.rst : Change documentation about .coafile Tutorial.rst: Change documentation about .coafile Jan 16, 2018
Copy link

@ishanSrt ishanSrt left a comment

Choose a reason for hiding this comment

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

Commit body, terminate sentences with full stops

@Rahmeen14
Copy link
Contributor Author

@ishanSrt Thank you, have made the necessary changes.

@ishanSrt
Copy link

👍 LGTM

@Makman2
Copy link
Member

Makman2 commented Jan 16, 2018

ack 5ab3f3f

@jayvdb
Copy link
Member

jayvdb commented Mar 10, 2018

@gitmate-bot rebase

Replaced the deprecated [Default] section by [cli].
Assigned True to use_spaces instead of yeah.
These changes were made because the previous documentation was
inconsistent with the observation upon execution of coala.

Closes coala/coala#4968
@gitmate-bot
Copy link

Hey! I'm GitMate.io! This pull request is being rebased automatically. Please DO NOT push while rebase is in progress or your changes would be lost permanently ⚠️

@gitmate-bot
Copy link

Automated rebase with GitMate.io was successful! 🎉

@jayvdb
Copy link
Member

jayvdb commented Mar 10, 2018

@gitmate-bot ff

@gitmate-bot
Copy link

Hey! I'm GitMate.io! This pull request is being fastforwarded automatically. Please DO NOT push while fastforward is in progress or your changes would be lost permanently ⚠️

@gitmate-bot
Copy link

Automated fastforward with GitMate.io was successful! 🎉

@gitmate-bot gitmate-bot merged commit f446b98 into coala:master Mar 10, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

Successfully merging this pull request may close these issues.

Problem in the getting started with coala tutorial
9 participants