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

confusing end of welcome chapter #45

Open
wilzbach opened this issue Aug 21, 2016 · 5 comments
Open

confusing end of welcome chapter #45

wilzbach opened this issue Aug 21, 2016 · 5 comments

Comments

@wilzbach
Copy link
Member

From @wilzbach on May 25, 2016 13:37

Could you point out why it is confusing to you.

I had the same experience. The page number is 5/5 and the arrows are grayed out. That looks like "the end" to me.

Currently the text says:

"Either use the navigation panel at the bottom or press the right arrow
key."

But before that, it says "Congratulations for finishing the first chapter. You're now ready to dive into the world of D." which may (and did to me) mean "this is the end, go out there and try out D now." It's easy to miss "first chapter" in there.

What could we add to avoid the confusion?

  1. Arrows should not be gray (how about green?)

  2. 5/5 doesn't carry much meaning for me and potentially confusing as it did

Copied from original issue: dlang-tour/core#187

@wilzbach
Copy link
Member Author

  1. Add more text about the next chapter e.g.

"In the next chapter you will learn about the basics about D"

@wilzbach
Copy link
Member Author

From @stonemaster on May 25, 2016 17:18

  1. Arrows should not be gray (how about green?)
    I think green won't fit in the overall colour scheme. But I do agree that gray might not have been the optimal choice. Maybe some tone of D's red might help already.

  2. 5/5 doesn't carry much meaning for me and potentially confusing as it did

We could just drop that information altogether? It's something taken as "inspiration" from the Go tour.

  1. Add more text about the next chapter e.g.
    "In the next chapter you will learn about the basics about D"

There is already the next/previous chapter's title near the arrows. I don't that this is needed as it will just create more visual noise. But maybe display could be organised to it clearer that the arrows have the purpose to navigate.

@wilzbach
Copy link
Member Author

We could just drop that information altogether? It's something taken as "inspiration" from the Go tour.

I think structure and showing where exactly you are is great, but maybe we can find a better way?
e.g. #201
That being said we can at least drop the (ugly) numbers for now?

  1. Add more text about the next chapter e.g.

The idea was to put this into fulltext.

@wilzbach
Copy link
Member Author

btw related to #40 ;-)

@wilzbach
Copy link
Member Author

idea: maybe we can just use a slim 1px progress line for each chapter? (instead of displaying the numbers)

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

No branches or pull requests

1 participant