EXCLUSIVE: Consistency for the Aptivi Newsroom and API docs design

Last week, we have reported that the June 2026 redesign for the Aptivi Blog had finished in two stages: design and structure. This took a lot of effort into ensuring that responsive design was applied across all form factors, including mobile phones and tablets. This was a project that was planned to fix problems that plagued the older design that we revealed back on February 2026 as part of the bigger milestone.

As we have gathered great feedback, we’d like to extend this effort to include both the API documentation of our projects that use .NET and the Aptivi Newsroom website. We will perform the necessary changes to ensure that our design is:

  • Consistent: We will update both sites to be consistent with our new design language, including colors and other element properties.
  • Cohesive: We will update both sites to ensure that they become readable across all form factors.
  • Reliable: We will update both sites to make the design elements, such as text and images, adapt to different form factors, while making sure that problems related to design are resolved.

This design change, however, has no schedule, so it will slowly roll out according to the results of our experiments. If things go well, we will start rolling it out to a small batch, such as Nitrocid and Terminaux, before extending to larger batches to make sure that any last-minute bugs with the design can be caught early.

Aptivi Newsroom will get the updated design first, then the API documentation design update will come in tiers, which will span for three weeks, as we keep testing the new design to ensure that it reliably achieves our goal.

Currently, there is no set date as to when we’ll start rolling out the changes, but we will showcase them to you in a separate Aptivi Newsroom article once we start pushing the design updates.

#API #APIDocs #APIDocumentation #AptiviNewsroom #docfx #DocGen #Hugo #news #Newsroom #Tech #Technology #update

Aptivi Development Toolkit (ADT) and modern GitHub Pages deployment workflow rollout for our projects is finished!

#ADT #Aptivi #GitHub #DocFX #dotnet #csharp #programming #TechNews #TechUpdates

https://officialaptivi.wordpress.com/2026/03/18/github-actions-web-deployment-and-adt-rollout-complete/

GitHub Actions web deployment and ADT rollout complete!

We have documented the improved process for GitHub Actions workflows in our projects regarding both the development toolkit and the web deployment process. This process was necessary to ensure that…

Aptivi
Our sincere apology regarding API docs deployment glitches

We have earlier announced that the redesign for the whole Aptivi branding was complete, and that we had updated all the websites to make sure that they reflect the new, modern, bold design. Upon fu…

Aptivi
Mobile experience made better with our sites

Mobile users have their own layout when it comes to web browsing, as sites have to be responsive for narrow screens to be able to adapt to the constraints for such screens. Responsive web sites adj…

Aptivi

Feeling like I should be able to publish the new API documentation site for @xunit in the next day or two.

The last big issue to resolve is dealing with DocFX's `uid` collisions when trying to have more than one version of an API documented on the site at a time. Should be a fairly mechanical YML + JSON transformation after `docfx metadata`. #DotNet #DocFX

Does anyone know of a good blog plugin for #DocFX?

I wanna be able to have it build a simple blog feed similar to how e.g. jekyll does things. Preferably complete with an RSS feed and everything.

I guess the worst case here is I could just embed another markdown blog engine into docfx. Hrm.

#DotNet

RenovateBot is a wonderful piece of software. 👏🏆

In about 5 minutes, I added a custom manager that can pick up the latest #docfx release from nuget and plop it into the Dockerfile for our docfx-action project. Delightful that it was so simple & well-documented.

How to Set up Netlify Deploys for Docfx using GitHub Actions

We currently use docfx to publish the NUnit docs, because it has a lovely capability of generating docs for our API reference in addition to all our articles.

SeanKilleen.com