2022 Updates

27 Dec

Improvement API Reference: Curl requests with application/octet-stream media type would show using --data-binary instead of --data to preserve new lines and carriage in the payload.

19 Dec

Bug Fix Hosting: Fixed a bug where multi segment base path could cause default page to load instead of the requested page.

14 Dec

Improvement Usability: Enhanced usability of template and synced blocks windows.

30 Nov

Bug Fix API Playground: Fix for post/put/patch requests with query strings and form data.
Improvement API Playground: When an API definition doesn't have a server URL, the window location is now used in the example requests.

28 Nov

Bug Fix Dashboard: Fixed a bug where dashboard no longer loads.

27 Nov

Bug Fix Page Linking: The page chooser was not always showing in the correct position.

22 Nov

Bug Fix API Reference: Some API references were failing to get deleted.

21 Nov

New API Editor: Every API definition edit is now saved in revisions. Edits go into drafts until published.
Bug Fix API Playground: Post/Put/Patch requests with query strings were not performed correctly.
Bug Fix API Playground: Post/Put/Patch requests with no body were not performed correctly.

11 Nov

Bug Fix Index List: Index list no longer shows hidden pages too.

9 Nov

New API Editor: We now have a visual API Editor!
Bug Fix API Playground: Responses for OAS2 weren't showing.

5 Nov

Bug Fix Security: Links in email invites could have been expired already.

27 Oct

New API Reference: Basic authentication security scheme now shows username and password fields in the API Playground for easier authentication.
Improvement API Reference: Simplified how Python requests JSON request body show.
Improvement Sidebar: You can now search for a project rather than having to go through the list.

25 Oct

New API Reference: We now support uploading OAS 3.1, and listing webhooks 🎉.
Improvement API Reference: URLs, headers, queries and other pieces of data in cURL requests are now enclosed in single-quotes so they can be copy pasted into a terminal without modification.
Improvement API Reference: Server/host block is no longer needed when uploading an OpenAPI file.

18 Oct

New GitHub Code: Embed code from GitHub repository right into DeveloperHub.
New Index List: Insert a list of child pages dynamically into the page.

12 Oct

Bug Fix Cloning: When version is cloned, hidden pages in existing version were not hidden anymore in the cloned version.

4 Oct

Bug Fix Image: Some uploaded images were not showing correctly when zoomed.
Bug Fix API Reference: Fix to when additionalProperties are showing to be required.

25 Sep

Bug Fix API Reference: Fix to URL encoding placeholders in example requests/responses.

17 Sep

Improvement API Reference: Tables or examples that are too long get collapsed by default, and can be expanded with a button.
Improvement API Reference: Code blocks from markdown look like code blocks now.
Bug Fix API Reference: Inline code did not have the right font.

13 Sep

New Custom Login: Ability to generate a JWT token in DeveloperHub for easy access.

12 Sep

New API Reference: Request parameters which have an object type now render correctly in the request table and the examples.
New API Reference: Example responses description which have markdown are now rendered in markdown.

06 Sep

New Security: Ability for projects to be protected by email invites.

04 Sep

New API Reference: OAuth 2.0 Authentication is now possible in Try It Out API Playground.
New API Reference: Add support for Custom Interceptors.
Bug Fix API Reference: Fixed issue where description might get converted from markdown twice, causing tables to look wrong.

25 Aug

Bug Fix Editor: Having empty headings could cause content until the previous heading to be deleted.

24 Aug

New API Reference: Server URL variables are now modifiable in the UI.
Bug Fix Editor: Editing an existing page link was broken.

18 Aug

Improvement Editor: sign now shows on new lines even if bold/italic/formatting was applied.
Bug Fix Editor: Fix to separators functionality. There was a special case where separator could contain text, which wouldn't be saved.
Bug Fix API Reference: Inline code in server blocks was not coloured correctly.

17 Aug

New Search Analytics: Ability to see search analytics for the past 3 or 6 months.
Bug Fix Editor: Link selector, inline blocks and other selectors were not showing at the right place inside tabs.

14 Aug

New Tabs: Tab blocks are now available in beta.
New Link Analysis: In addition to showing broken links under page title, we also show unreachable links too. They are all accessible through link analysis in Page Info.
Improvement Editor: Enhancement to how Backspace key works in the editor, ensuring it doesn't delete accidentally more than intended.

8 Aug

Improvement Editor: Documentation index is now collapsible when editing.

7 Aug

New API Reference: Index can now be set to collapsible.
Improvement Editor: Improved how the editor handles mixed bold/italic formatting, including overlapping formatting.

5 Aug

Improvement Editor: Disabled ⇧ + ↵ completely in the editor. Line breaks use is unusual in technical writing, and they were not supported in any case. Please use the proper elements for providing spaces between content.

4 Aug

New Editor: Added a guard to ensure you do not close the editor tab when you have unsaved changes.
Bug Fix Editor: Fixed some bugs with mixed bold/italic formatting and empty headings.

26 Jul

New Server Headers: Ability to add custom server headers for security purposes.

25 Jul

Improvement API Reference: Objects in request and response tables are bolded now
Improvement API Reference: Enhanced when example requests and responses stick when scrolling.

21 Jul

New PDF Export: API References are now also exported into the PDF file.

19 Jul

New SEO: Added native option to disable search engine indexing of non-default version.
New Import/Export: API References are now exported and can be imported.
Improvement Table: Hitting Tab at end of a table will create a new row.

15 Jul

New Custom CSS: Ability to test on different frontend application version.
Change CSS: Removed .topnav-container fixed height and .mega-container margin-top. No visual changes.
Improvement Keyboard Shortcuts: ⇧ + ⌥ + D opens the page in editor if you were on reader site, and the reader site if you were in the editor.

14 Jul

cf0aac2

New URL Redirects: Added support for 301 server-side URL redirects.

13 Jul

Improvement Customisation: Custom CSS/Head Tags/Landing Page modals are now resizable to be able to see more code, and you can go to draft mode directly.
Security Comments: Resolved a possible XSS issue.

12 Jul

New API Reference: Added support for additionalProperties for request bodies.

11 Jul

Improvement API Reference: We've touched up the API References styles, and it's looking much better!
New Custom CSS: You can now pin frontend application version when you have heavy CSS changes so our modifications would not affect your readers site.
Security Hosting: We now apply X-Content-Type-Options: nosniff header to all docs sites to protect against malicious files.
Change Editor: We have tidied up the Project Settings menu.

29 Jun

d63b27a

Change Code Block: Rounded code blocks (inside documentation and references) borders.

28 Jun

New Hosting: Sitemaps for multiple projects hosted by DeveloperHub are available now.

27 Jun

Change Hosting: Changed the instructions for reverse proxy to include the forwarded request URI. This ensures sitemaps work for multiple projects on the same domain.

24 Jun

New Integrations: We support Google Analytics 4 IDs for Google Analytics now.

23 Jun

Bug Fix Integrations: Google Analytics integration might report an out-of-sync page title for a URL.

20 Jun

New Customisations: Added draft mode to Custom Landing Page, Custom HEAD Tags and Custom CSS customisations so you can test it before publishing.
New UI Translation: HTML lang attribute now changes according to the documentation locale.

15 Jun

New Video: Can embed videos natively from Youtube, Vimeo, Loom and direct URL.

11 Jun

Bug Fix Editor: Empty headings no longer show as hash characters after saving.
Bug Fix Editor: Menu for selecting links and inline variables now opens as expected at start of tables and bullet points.

06 Jun

New Broken Links: Analyses also internal DeveloperHub links which probably should have published docs links.
New API Reference: Recognise date-time parameter format.

05 Jun

New API Reference: Recognise UUID parameter format.
New API Reference: Automatic API Playground headers and parameters validation. Enums show as options.

23 May

New API Reference: API Playground is now available!

15 May

New PDF Export: Share a permalink to allow readers to always download the latest PDF.
New Custom HTML: Custom HTML static contents are now searchable using the search box.
Bug Fix Private Docs: URL fragment was not preserved when private docs login showed.

12 May

New Index: Pages can now be hidden from index, but still accessible through URL or links.
Change Unlisting: Unlisting is now unpublishing. An unpublished page cannot be viewed by readers.
Change PDF Exports: Any teammate can now download PDFs. Previously it was only publishers and admins.

18 Apr

New API Reference: Show integer formats if defined in the type column of request and response bodies.
Bug Fix API Reference: Response user-defined examples may have not shown if there is no authentication scheme.

15 Apr

New API Reference: Show additionalProperties in responses.

09 Apr

Change Documentation/API Reference: Creating a new documentation/API reference orders it last. System used to order it first.
Bug Fix Documentation/API Reference: Ordering documentation/API reference could have failed previously due to being out of sync. This is now mitigated and ordering is ensured.
Bug Fix Index: Ordering a category to the bottom of the index may have merged pages of two categories in an unexpected way. This is now mitigated and ordering is ensured.

06 Apr

New API Reference: Support for externalDocs under schema object.
New Tables: Added minimal support for copy/pasting table rows.
Bug Fix API Reference: Response body table showed no response body if there was no schema but headers existed.

31 Mar

New SEO: Ability to manually specify page description for SEO search engines.

28 Mar

Bug Fix Index: categoryToggle advanced setting also prevented parent page indices from auto-collapsing.

18 Mar

Bug Fix Page Linking: Clicking on a page link inside a table when in the editor was not showing the window to change the details.
Bug Fix Index: Edit Title was not showing the page title by default, and had a misleading button label.

16 Mar

New Code Block: Add Groovy as a language.
Bug Fix Import: Importing pages with images hosted by us was showing an error.

14 Mar

Bug Fix API Reference: Request bodies having no content may not look good. Response body having content with no media type map may not look good.

10 Mar

New API Reference: Support for servers under operation object. If there are servers defined, the first one will be used for the example request server URL.
Bug Fix API Reference: Dashes in tag titles were getting stripped.
Bug Fix API Reference: Responses with text/html media types were not rendered correctly.

06 Mar

New API Reference: Support for multiple security schemes for API or operation security.
New Custom Login: Redirect to a URL on authentication error.

05 Mar

New CSS: Added --brand-active CSS variable for brand colour over light controls.
New API Reference: Rendered markdown tables from descriptions now look like pretty like our tables.
Change API Reference: Rendered markdown separators from descriptions now have margins.

01 Mar

New Teammates: Admins can now change a teammate's name.
New Teammates: Owner can transfer project ownership without needing to open a support ticket.

28 Feb

Change Images: All images are now served through our own AWS Cloudfront distribution and saved in our S3 buckets.

19 Feb

New API Reference: Show API Reference description headings in the index.
New Index: Allow use of variables in external links.

06 Feb

New API Reference: Option to show accept header.
Bug Fix API Reference: Authentication header might not show if reference is set to expand tags.

31 Jan

Change API Reference: If a schema has no type, we'll show faded <type> in the table.

28 Jan

Change Index: We now show a warning when you are trying to create a page when a page is not saved yet.
Bug Fix Separator: You can now click down or enter to continue writing below the last separator on the page.

27 Jan

New Page Linking: Instead of removing link all together, you can now click on a link to modify its label and linked heading.
Change Version: Version now gets unpublished automatically if all sections below it are unpublished. You also cannot publish a version anymore which has unpublished sections.
Bug Fix Index: Re-arrange page menu might get hidden if category titles were too long and screen size was small.

24 Jan

Bug Fix Index: Drag and drop is much faster now when using a trackpad.

17 Jan

New Index: Rename index title without renaming the page.

12 Jan

New Documentation: You can now control publishing state for documentation sections.
New API Reference: You can now control publishing state for API reference sections.
Change Editor Layout: All version, documentation and API reference settings are now available under a Settings menu to declutter the menus.
Change Page Info: Page has moved from the left sidebar to the right sidebar under Page Info.
Change Documentation: All documentation that already existed with no listed pages became unpublished. You can no longer have a documentation that is published without any listed pages under it.

07 Jan

Bug Fix Tables: Fixed an issue where creating two columns consecutively would add them in the wrong order.
Bug Fix Tables: Keyboard cursor was not in the right place for empty headers.

04 Jan

New Users: Ability to deprovision teammates from a managed organisation.
New Feedback: Revamped how feedback inbox looks and page feedback. You now see all feedback without having to toggle between read and unread. Also, feedback without messages also show in the inbox. Moreover, you can click on the chart above feedback inbox to look at the feedback for that day.

Last updated by Zaid Daba'een on Apr 26, 2023

Anything missing? Leave us feedback