Explore

Publishing checklist

Best practices for getting your doc into the Doc Gallery

John Scrugham

So you want to share your creation with the world in the

Doc Gallery⁠

! Here's how to do.

Set up

Use your personal Coda account (aka your @gmail.com email). That way, you'll never lose access to your creation.

Copy your live production doc or create a new doc (type

coda.new⁠

in your URL)

Invite your co-creators (like me at john@coda.io) to be able to edit it.

Pieces of your doc

Write an introduction: The first page of your doc should introduce the audience to your lovely creation. You can think of it like a blog post.

💡 Discuss the problem you wanted to solve: it can be general, or specific like calling out the tools you were using that didn't work for you. Share the solution (how Coda helps solve that). Yuhki's

intro "blog post"⁠

to his roadmap doc is a great example.

Add the Options that make your intro look great like a cover image, subtitle, and author.

⁠

💡 Formatting options:

Cover Image: This is what gives visual excitement to your doc and is the photo used on embeds and social posts. Hover over the image and use Unsplash or upload your own pic!

Subtitle: Gives more context to your doc and also shows up in the Gallery search, so you can use keywords you didn't use in the doc title.

Authors: Make yourself (and anyone you worked with) the authors. This gives readers / users an idea of who you are, and a quick way to get to your maker profile.

Create the solution: Share what you've built in Coda

💡 Set up:

Use charts, colors, emojis, images to make it more visually engaging.

Don't use real company data. Come up with funny company or people names, or use

fake name generators⁠

. If you need people in your doc, you can invite the fake users:

List of Fake People

List of Fake People

Person

Alan Chowansky

al@codadoc.io

Lola Tseudonym

laura@codadoc.io

Buck Dubois

lane@codadoc.io

Polly Rose

molly@codadoc.io

James Booth

jerols@codadoc.io

Mary Jones

mallika@codadoc.io

Maria Marquis

maria@codadoc.io

Lawrence Fitzgerald

coda@codadoc.io

Joel Davis

joe@codadoc.io

Ben Lee

ben@codadoc.io

There are no rows in this table

⁠

Try to keep how things work apparent with buttons and columns all showing ( fancy behind-the-scenes magic to a min.).

Some more inspiration for how to create a delightful doc:

https://coda.io/@john-scrugham/building-a-delightful-doc⁠

⁠

Publishing

Publish the doc so others can see what you've made and make their own copy if they want to use it.

If it’s your first time publishing, then you’ll want to create a maker profile. We’d love for you to include your title / company, a fun blurb about yourself, and links to your social profiles like Twitter and Linkedin. We think

Jenny⁠

Aislinn⁠

, and

Yuhki⁠

’s profiles are quite nice.

⁠

Common Setting choices

Common Setting choices

Done

Setting Name

Choose

Why

Discoverable by anyone

So that people can search and find your amazing creation.