Skip to content

Create design-history-template.md#214

Open
dannychadburn wants to merge 1 commit intomainfrom
newtemplate
Open

Create design-history-template.md#214
dannychadburn wants to merge 1 commit intomainfrom
newtemplate

Conversation

@dannychadburn
Copy link
Collaborator

Added new guide for suggested design history structure

@frankieroberto frankieroberto temporarily deployed to screening-de-newtemplat-gobb9u August 29, 2025 09:12 Inactive
Copy link
Collaborator

@edwardhorsford edwardhorsford left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd like to suggest reframing this as a 'guide to writing a design history post' rather than a template.

I think it could work well as a guide / intro, but would be frustrating as an actual template. As an actual template you need to delete a load of bullets every time you use it. You also don't need to read the bullets for every post. I'd also worry about the existing headings getting over-used and making all posts too similar. It's also missing tags / dates / other sample things that might be helpful in a template.

- Explain how this addresses problems or improves user experience
- Go into detail, ideally in context with visual aids (screengrabs or recordings)
- Avoid including prototype or live service links – these evolve so may not match what people are seeing in the design history
- For all media, include descriptive alt-text and captions
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't think all media need captions.

@edwardhorsford
Copy link
Collaborator

There's this existing guidance. I'd possibly suggest we could have something half way between the two. Avoid being too prescriptive, but try to nudge towards better posts.

It would be good to encourage that posts be shorter / more to the point. It's more likely that they'll get written and read that way.

@frankieroberto frankieroberto temporarily deployed to dsps-design-newtemplate-ik1m0c February 27, 2026 10:25 Inactive
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants