-
Notifications
You must be signed in to change notification settings - Fork 80
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
Understanding the reason for an instruction #110
Comments
@Knowledgeissweet, that's a good catch!. Maybe we can include it in the documentation. Tagging @chicken-biryani, @HarshCasper, @shubhamkarande13 for more insight into this! |
@Knowledgeissweet that's a great suggestion. Maybe one or two lines would be enough. Something like: 'Make sure you've switched to the develop branch since it consists of all the latest changes.' Or something similar. |
@HarshCasper , something I can do?? |
" Make sure you've switched to the develop branch To be updated, it consists of all the latest changes." @chicken-biryani does this suffice? |
@King-kay yep. Sounds reasonable! |
What does the current documentation state?
Where is this stated?
This is a link to the page where the issue is raised from
Why do you want to improve the statement?
The need to improve the circled section of the page hinges upon a need to better understand why the instruction required of the user of the doc was given. That is, answering the question on, "why the user should make sure to have checked out to the develop Branch for the FLINT Installation?"
What is the reason for this requirement here? What is the implications of not taking the required action?
I strongly believe this is a knowledge gap that needs to be filled in to create better documentation and satisfy users' innate need to understand why they have to take a step.
Proposed statement
The proposed solution, hence, is to state clearly the reason for the action requirement, alongside possible implication of not taking the step.
The text was updated successfully, but these errors were encountered: