πŸ‡ΊπŸ‡¦ New publish workflow, Spaces and more πŸ‡ΊπŸ‡¦

Some changes we've made to allow a better user experience.

1. Staging becomes Preview

Our Staging environment has been renamed to Preview environment and is now publishable — just as the Production environment. Now everybody can preview their documentation sites BEFORE setting their domains — a huge time saver.

On top of that, the Preview environment is now authenticated by default for users already authenticated in Archbee. This makes it possible to create your documentation site privately and make it public only when it's ready, and you've configured it for Production.

2. Collections become Spaces

For many people `Collection` does not reflect what we mean.

Now Spaces, collections were meant to be the first layer of document organization. Spaces sound more familiar from similar software that's focused on internal documentation.

Basically:

  • Documents are organized into Spaces;
  • Spaces are organized into Sites (which we'll introduce shortly).

3. Workspaces become Orgs

Our Workspaces feature allows you to use a single login to be in the context of multiple companies, negating the need to re-login with another account. 

This is great. However, many users get confused by the concept, buy a subscription and assume it's for all Workspaces they create. Each workspace has its own subscription because what we really mean by workspaces is "organization". 

We considered a switch to "Teams" but we realized it could also mean that there are separate teams in an organization. So we're making this semantic change to reflect that.

4. Code Editors Update

All code editors have been updated to allow multiple tabs using the same language, drag and drop to reorganize tabs, and performance improvements.

5. Better Markdown converters

We've made a bunch of modifications to our Markdown converters and now they catch more of our custom blocks, that were previously hard to translate to markdown. For example, our Link Blocks and Tabs now translate to a custom Markdown directive, that we understand and other software can easily be made to understand.

6. Removing favorite collections (now spaces)

The favorite collections (now spaces) feature has been removed, for various complicated reasons. You can still drag and drop spaces to organize them as you see fit, potentially putting spaces you care more about at the top of your list.

7. Lots of UI changes and improvements

We've reorganized many things around the UI to build a better user experience.


Cheers from the fearless Archbee team, meaning is not afraid to deploy to prod on Fridays or any other day 💪

At least that we can do to feel 0.1% as brave as Ukraine people.

#WeAreWithUkraine 🇺🇦


50+ improvements

As promised to many of you, we're focusing on improving the functionality we already have as opposed to adding new stuff. 

We've improved the performance of the app, the design system, our libraries & code, the self-service abilities of the system.

Here are some highlights:

  • custom HTML with handlebars templates in custom footers or custom landing pages for documentation sites; read more here: https://docs.archbee.io/custom-landing-page;
  • improved image rendering; we've changed our CDN for images with one that renders sizes dynamically and allows people with smaller screens (e.g mobile) to download the exact size of images they need; we also changed the way image widths/heights are calculated so no layout shifting will happen anymore;
  • user downloadable invoices; download any invoice on demand so that you don't have to look for them in your email;
  • ability to appoint a new super admin; this also changes the email that Stripe sends invoices to;
  • ability to change email address by yourself;
  • UI improvements all over; we've tightened our design system even more; more consistent colors and spacing;
  • better automatic scrolling in the document tree section;
  • improved search algorithm and faster instances on AWS for search indexing;
  • we've upgraded most of our code to the latest libraries so you get the benefit of improved performance and security;
  • reduced load time for public collections by 20%;
  • reduced load time for documents by 25%;
  • improved callout blocks;
  • more accurate reading time prediction by using a new algorithm;
  • faster real-time sync between people looking at the same document;
  • better table of contents rendering;
  • improved loading time of the knowledge graph on workspaces with 1000+ documents;
  • improved document tree drag & drop accuracy;
  • improved blockquote rendering.

Enjoy!

May Product Update

In a nutshell, we've been hard at work improving our core tech, but we've also been able to sneak in a couple of nice to have features.

Updates

  • documents now load 7-10% faster;
  • we were able to shave 150 to 200 milliseconds off the realtime sync algorithm, making realtime collaboration better;
  • we've added more and better editor shortcuts (Markdown included); check the new shortcuts by hitting Ctrl (or Cmd on Mac) + /;
  • we've changed our CDN to AWS CloudFront, and setup better firewalls to our APIs to mitigate next Denial of Service attacks;
  • certificate generation for hosted docspaces on your domains now happens in maximum 1 hour since the DNS has propagated, and we also have lowered their regeneration rate to 2 months;
  • hosted docspaces are now 15% to 60% faster, as we were able to cache some of the content close to your customers; this will also improve your SEO;
  • UI improvements across the board: more consistent spacing and colors throughout the app; cross platform scrollbars;
  • better support for Safari and Firefox; there's still work to be done here, but we strive to be 100% cross-browser as ~15% of you don't use Chrome-based browsers;
  • better support on mobile browsers;
  • we've started doing automated phishing scans to prevent malicious use of our platform;
  • our embed integrations come out of beta and are now generally available;
  • iframe embeds and custom javascript are generally available but will stay in beta for a while longer;
  • docx import comes out of beta.


What's next?

  • workspace-level domains, share any amount of docspaces in an URL format like this: https://docs.yourdomain.com/docspace1 https://docs.yourdomain.com/docspace2;
  • desktop app;
  • improved datatables that draw inspiration from AirTable;
  • continued core technology improvements;
  • many misc. features asked by you; thank you for your great ideas in the Feature Wishlist, we watch them closely and many of them will get implemented.

Easter product update!

Happy easter! Here's what we've been working on the past weeks!

Document expansion preservation

Until now, everytime you opened a docspace, every document would expand and you would be able to see every one of their children.

While this was good for small docspaces, it was a nightmare for docspaces with more than 80-100 documents.

Now the document expansion will be saved and restored later for each user.

Swagger HTTP headers

You can now add headers to our Swagger UI component. This allows you to make authenticated requests to your API endpoint.

GraphiQL HTTP headers

You can now add headers to our GraphiQL component. This allows you to make authenticated requests to your API endpoint.

Docspace events

Until now, it was really hard to get a grasp of what your team has been working on and what happened to certain docspaces.

From now on we record events for docspaces and neatly show them when you click on a docspace!

Editor fixes

As you report small bugs in the editor to us, we fix them to improve the user experience. We fixed a bunch of bugs related to lists, link editing, paragraph spacing and more.

Editor performance

We made some optimisations to our editor, and document loading is now 10 to 15 percent faster.

New chat system for support

We've migrated to Crisp.chat for providing realtime support.

New feature upvoting and roadmap system

Please go in there and upvote or suggest your desired features!