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

Suggestion regarding textbook #101

Open
aquohn opened this issue Nov 20, 2019 · 5 comments
Open

Suggestion regarding textbook #101

aquohn opened this issue Nov 20, 2019 · 5 comments
Labels

Comments

@aquohn
Copy link

aquohn commented Nov 20, 2019

Many essential sections (especially those on UML) are collapsed by default in the textbook. Although this makes for easier browsing, it may be helpful to be able to expand all the collapsed sections with a single click, or at least have them in their expanded state by default when opened in the print-friendly mode. Just a suggestion to make it easier to use the textbook!

@okkhoy
Copy link
Collaborator

okkhoy commented Nov 20, 2019

Do you mean this: https://nuscs2113-ay1920s1.github.io/website/se-book-adapted/chapters-printable/uml-printable.html

There is a printer-friendly version of the book on the website! All you need to do is click on the printer icon!

For that matter, the entire text is present in one huge page: https://nuscs2113-ay1920s1.github.io/website/se-book-adapted/print.html

@aquohn
Copy link
Author

aquohn commented Nov 20, 2019

I was referring to the latter link, where the Modeling section appears as such:

image

Your response made me realise that the content is actually replicated in the UML section, however! So it's just a bit confusing, because the same info is present in collapsed form in the Modeling section, and in non-collapsed form in the UML section.

@okkhoy
Copy link
Collaborator

okkhoy commented Nov 20, 2019

Errr, that is because modeling needs UML.

Now that you raised a valid point, I guess next time, I will remove modeling part altogether to remove confusion and just include the small blurb along with UML section 😄

I will record it in the website bugs issue

@D-uke
Copy link

D-uke commented Nov 20, 2019

Reading some of the answers provided in the textbook sometimes makes me doubt myself. If I am actually learning some legit knowledge, instead of some personal opinions that some famous guy had.

image

@okkhoy
Copy link
Collaborator

okkhoy commented Nov 21, 2019

@D-uke Some of the discussions related to agile methodologies (and some principles as well!) are opinions from established practitioners in the industry.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

3 participants