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

x/playground: document all its tricks #32294

Open
bradfitz opened this issue May 28, 2019 · 3 comments
Open

x/playground: document all its tricks #32294

bradfitz opened this issue May 28, 2019 · 3 comments

Comments

@bradfitz
Copy link
Member

@bradfitz bradfitz commented May 28, 2019

The playground is underdocumented:

  • test mode
  • multiples files, mod files
  • images
  • sleeps
  • clearing screen

Document & link from play.golang.org.

@bradfitz

This comment has been minimized.

Copy link
Member Author

@bradfitz bradfitz commented May 28, 2019

@ysmolsky

This comment has been minimized.

Copy link
Member

@ysmolsky ysmolsky commented May 29, 2019

Thanks, I agree, especially after the addition of modules. I saw couple of times in tickets people raising eyebrows when they hear about playground having testing. How do we proceed on this beyond extending the about page? It seems to be that nobody reads the about page. Maybe writing a post for Go blog?

Also should we document and expose the way multifiles supported via txtar or wait until we have some kinda non-text interface for it?

I admit, I was distracted heavily from playground by my job, and I have lot's of unclosed playground tickets here :-)

@bradfitz

This comment has been minimized.

Copy link
Member Author

@bradfitz bradfitz commented May 29, 2019

I think to the right of the Share button we should have:

Examples: [  fun trick 1             \/ ]
          [  fun trick 2                ]
          [  fun trick 3                ]
          [  fun trick 4                ]
          [  fun trick 5                ]
          [  fun trick 6                ]

And have those pre-load some representative features (multi-files, tests, images, sleep animations w/ clearing the screen, etc).

That would make it more prominent.

The golang.org homepage has something similar:

Screen Shot 2019-05-29 at 7 58 35 AM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
3 participants
You can’t perform that action at this time.