User Docs

[patflynn]

For Alpha we want to at a minimum:

• Provide clear introduction to Tessera why it exists and what it's for
• Provide examples with some docs
• Provide a smooth guided through the Alpha Call-To-Action
• Codelab? Can we leverage Go's example code docs support

[mhutchinson]

I think a reasonable exit criteria for this is if a developer with basic knowledge of what a transparency log is (but doesn't necessarily understand tiles) can come to the main Tessera Go Docs and perform the following actions:

• deploy an example personality and interact with it
• view the code and understand how the example personality works
• write their own personality

[roger2hk]

The godoc examples do not work as expected for some reason.

https://pkg.go.dev/github.com/transparency-dev/[email protected]/api/layout

[mhutchinson]

It could be that it needs to pull all of Tessera and its deps in order to build that, and it runs out of time?

[roger2hk]

It could be that it needs to pull all of Tessera and its deps in order to build that, and it runs out of time?

I believe so. The Go playground build timeout is 10 seconds.