PostHog Handbook Library / Engineering

352 words. Estimated reading time: 2 min.

# Changelog entries

The changelog publishing process is run by the .

Changelog entries can be created in two ways:

1. Change the status of an existing roadmap or WIP entry to "Complete"
2. Create a new changelog entry on the changelog page.

Both options are available when you're signed into posthog.com as a moderator.

For more details on the publishing process, check out the How to publish changelog handbook page by the .

### Fill out the proper paperwork

Make sure all fields are filled out correctly before creating an entry.

#### Date

Set the date to the feature's release date. If updating from a previous roadmap or WIP entry, change the date to the actual release date (rather the date where the team started working on the feature).

#### Team and author

Select the team that is responsible for the change, and choose the author of the feature. If there's no individual lead on the feature or update, set the author to the team lead.

#### Categorization

Select the product or product area that the change is relevant to, and set the type of update. These can be used on the front end to filter down to a subset of changes.

#### Title and description

Be succinct with the title. Check the format of existing entries for inspiration.

#### Options

The Show on homepage option aggregates the entry to the _"We ship weirdly fast"_ calendar on the homepage. Only select this option if the milestone is impressive enough to be remembered years from now. The point of the calendar is to show the frequency of shipping big features, not to highlight every single update.

#### Social sharing

The has created an image generator that takes the information from the changelog entry and creates a square image for sharing on social media. Read the blog post to learn how it works.

The customization options are designed to allow you to format the copy and image so it looks as good as it can. If you need suggestions or aren't sure if your changelog image meets our quality standards, don't hesitate to post in #team-website-and-vibes for a second opinion.

Canonical URL: https://posthog.com/handbook/engineering/posthog-com/changelog

GitHub source: contents/handbook/engineering/posthog-com/changelog.mdx

Content hash: `0a0393166a13dddf`

Static reader notes

- `MDX_COMPONENT_STATIC_ADAPTER`: Adapted interactive MDX components for static reading: CalloutBox, PrivateLink, SmallTeam.