search

golang / go

The Go programming language
https://go.dev
BSD 3-Clause "New" or "Revised" License
122.88k stars 17.52k forks source link

tour: introduce collapsible hint sections on page #12885

Open minux opened 8 years ago

minux commented 8 years ago

Some recent CLs to the tour added hints to certain problems where the user used to have to think for themselves.

I suggest that we add collapsible hint sections to hide these spoiler contents by default.

davecheney commented 8 years ago

I'd prefer not to do this. Experience has shown that many tour users font read the text when it is right in front of them, hiding it would be counter productive.

On Fri, 9 Oct 2015 11:22 Minux Ma notifications@github.com wrote:

Some recent CLs to the tour added hints to certain problems where the user used to have to think for themselves.

I suggest that we add collapsible hint sections to hide these spoiler contents by default.

— Reply to this email directly or view it on GitHub https://github.com/golang/go/issues/12885.

adg commented 8 years ago

I would prefer to write more text to go inside collapsable sections, rather than hiding any existing text.

There's a lot more explanation we should give, and we should give it to people who are interested.

On 9 October 2015 at 11:28, Dave Cheney notifications@github.com wrote:

I'd prefer not to do this. Experience has shown that many tour users font read the text when it is right in front of them, hiding it would be counter productive.

On Fri, 9 Oct 2015 11:22 Minux Ma notifications@github.com wrote:

Some recent CLs to the tour added hints to certain problems where the user used to have to think for themselves.

I suggest that we add collapsible hint sections to hide these spoiler contents by default.

— Reply to this email directly or view it on GitHub https://github.com/golang/go/issues/12885.

— Reply to this email directly or view it on GitHub https://github.com/golang/go/issues/12885#issuecomment-146725036.

minux commented 8 years ago

Yeah, the intention is not hide any existing text. The new collapsible sections will contain more detailed explanations and when new questions arise, we can answer them in the collapsible sections so that the page is not cluttered with unnecessary text.