Skip to content

Latest commit

 

History

History
85 lines (61 loc) · 2.59 KB

standard.md

File metadata and controls

85 lines (61 loc) · 2.59 KB
applied_at applies_to is_impactful is_new_feature collapse show_excerpt release_source_url
{{applied_at}}
{"applies_to"=>nil}
{"is_impactful"=>nil}
{"is_new_feature"=>nil}
true
true

{{{title}}}

About titles: good titles are less than 50 characters, explain what changed, and follow previous similar entries. For example:

  • Box CLI v3.0.0 released
  • New Metadata Query APIs available
  • Change to metadata instance version

Everything behind this comment is hidden by default if the collapse value in the frontmatter is set to true and show_excerpt is also set to true.

Start with a small section that explains in basic terms what has changed and how this impacts a customers. Make sure to add to related content, for example:

  • A guide links to the developer.box.com/guides/tooling/postman/ guide
  • An endpoint links to the developer.box.com/reference/get-files-id reference docs
  • A resource links to the developer.box.com/reference/resources/file reference docs

Make sure to use back ticks (\) to escape any words that would not pass the spellchecker or would not need translating. For example:

  • Product names like NodeJS
  • References to function names like getFileById(), BoxConfig.doThatThing(), etc
  • References to variable names like file_id, allow_access, etc
  • Version numbers, like v1.0.0, or V2.0
  • Or alternatively capitalize acronyms, like TLS, SSH, etc, as these will be ignored by the spell-checker as well.

Finally, include some examples. The more specific you can be the better. For example:

Before:

{}

After:

{
  "access": true
}

If at this point your file is becoming longer than 50 lines, you might want to consider using our short.md template instead.

Features

Remove this section if there are no new features in this release. Provides a list of new features in this release. Each entry in this list should start with a verb.

  • Add the ability to find files by path
  • Add support for the Zoom API

Updates

Remove this section if there are no new updates in this release. Provides a list of updates in this release that are not bug fixes or new features. Each entry in this list should start with a verb.

  • Remove the ability to search for files by path
  • Update our Node dependencies

Bug Fixes

Remove this section if there are no new bug fixes in this release. Provides a list of problems that have been fixed in this release. Each entry in this list should start with a verb.

  • Fix retry logic in authentication requests
  • Fix access to pterodactyl cage