Ansys Developer Case Study

Synopsys Mission: Empower innovators to drive human advancement.
 

As a trusted partner to companies across many industries, Synopsys provides comprehensive design solutions that make world-changing innovation possible, from improving healthcare outcomes to tackling climate change. The engineering teams they serve face increasing complexity, cost, and time-to-market pressure in developing silicon-powered, software-defined and AI-enhanced products. To maximize their customers’ R&D capabilities and empower their future innovation, Synopsys is re-engineering engineering with mission-critical solutions from silicon to systems.

Synopsys’ products deliver unprecedented insights, across multiple physics domains, into how their customers’ products will perform in some of the most challenging environments, helping engineers tame complexity and cost, improve product quality and accelerate development cycles. Synopsys’ industry-leading technology powers the innovation today that ignites the ingenuity of tomorrow.

However, before going live with the developer portal, developer documentation had been hidden away on a wide variety of websites and formats and was often only accessible on request.

To dissolve the documentation silos, Ansys wanted to build a developer portal for internal and external use, where content can exist side-by-side, and the developer portal can function as a self-service hub. This is the point where Pronovix came into the picture.
 

Powerful Third Party Search Integration

A comprehensive solution was implemented that searches not only on the developer portal, but across the Community Forum and PyAnsys (a separate domain for engineers, providing python access to Ansys simulation tools) as well.

On Pronovix’ advice, Ansys implemented SearchStax to index these systems and expose relevant content regardless of source. SearchStax allows the Ansys team to configure many search parameters themselves, react swiftly to emerging user needs, and simultaneously rely confidently on a feature-rich and cutting-edge search service.

Ansys Developer search result page with multiple filtering and sorting options.
 

Coherent Developer Documentation with Custom Importers

Before launching the developer portal, Ansys had to battle with having too many silos. These silos were created in part because Ansys has been growing by acquisition: more documentation was added with each new business unit. Pronovix helped them to build custom importers, which makes it easier to import dozens of already existing documentation packages. 

With the Zero Gravity developer portal, it is possible to migrate already existing documentation from GitHub (currently supported input types are JSON, MarkDown or Doxygen-generated HTML). 

Ansys’ Developer Documentation page.

Ansys’ teams prepare documentation packages through their already defined processes and most importantly, using the tools they already know. They then only have to change the way they output the docs, by flattening, file transformation, and packaging into a zip file. The system imports and sorts the content by the imported package, editors don’t have to change anything individually. This way, the documentation can be consistent and unified with a matching look and feel across disparate tools and product lines. It also helps to highlight where doc standards are missing and need improvement over having individual processes and publishing. 

The consolidated documentation also provides SEO benefits, as the externally available content will be indexed by Google and emerging generative AI platforms. This supports discoverability (how users know about a documentation package and where it exists) and findability (the user experience finding the information they seek). Furthermore, it ensures consistent branding and styling, provides access control, and can capture intent signals for marketing.

Access Control

As Ansys has both internal and external users, they use vocabulary-based access control. This method allows the Site administrators to restrict access permissions on a per page and per user level. Additional access vocabulary terms can be added later by Ansys, which gives them unrivaled flexibility to govern content access as needed.

User roles - in this implementation, as vocabulary terms - are assigned automatically during the SSO process. It’s also possible to assign registered users to different access groups individually. Also, a Site administrator can change access restrictions on each page on the fly if necessary. 
 

What is on the Ansys Developer Portal?

The current focus of the developer portal is providing use cases and documentation for their growing collection of client libraries. These libraries are in a variety of languages and offer client-side tools for building complex simulation workflows. This required a deeper level of customization and support from Pronovix and the ability to adjust the documentation model in Zero Gravity to support libraries instead of the traditional APIs found on most portals. This was a major decision factor in choosing Zero Gravity for Ansys.

App Catalog

Ansys’ aim is to make the developer portal a single source of truth, so the already existing app documentation was migrated to the developer portal into a unified App Catalog, including tags, search, and filtering functionalities for seamless user experience.

This comprehensive catalog is a marketplace that connects app creators and end-users, hosting both free and paid apps. The catalog contains partner and Ansys apps,

The app catalog provides the opportunity for creators to easily expose their applications to relevant users without extensive marketing efforts. At the same time it also favours users by providing an organised, filterable platform with quickly downloadable Ansys simulation apps.

Currently all app documentation is hosted on the developer portal, and in the future Ansys is planning on moving the actual apps to the portal as well. 
 

The Catalog also features “Verified apps” that have undergone a review process to ensure quality, compliance and relevance.

Knowledge Base

On the developer portal, the Knowledge Base lists several articles, ebooks, guides, and webinars. All of these elements contribute to Ansys’ business strategy. 

Guides: helps the user on their programming journey.
Articles: tips, tricks, cheat sheets for the users. 
E-books: downloadable content. 

With the help of the developer portal’s CMS, time-sensitive content can be scheduled to be published and/or unpublished at a desired date and time. This gives the Ansys team flexibility to author content when it is convenient for them and then publish as required by circumstances. An example would be their annual presence at the PyCon conference and upcoming LevelUp event.

Forum

Ansys relies on a best-of-breed third-party forum called Vanilla. The forum has three main categories: Product Questions, General Language Questions, and Announcements. These three make it possible to communicate both internally and externally, and a discussion can emerge. In addition, like the Portal, the forum allows private, Ansys-only conversations to be hosted on the same platform as the public conversations. This rapidly accelerates the ability to promote information to the public from those internal conversation sources. Just like Zero Gravity, this was a major factor in choosing a platform for the forums.

The integration between the developer portal and the forum is achieved in two ways: SSO (makes it easier for the user) and matching headers (for brand and user experience continuity). 

The Ansys Developer’s Forum section makes it possible to provide a platform for open discussions about product-related or general questions.

Building a community requires constant feedback, that is why the forum has an important role adjacent to the developer portal. Users can also contribute to make Ansys’ software better. 

User Feedback

Ansys desired to incorporate feedback mechanisms into their developer portal. In addition to advocating for developer portals, Pronovix aims to facilitate others’ success by acting as a partner and advisor: they wanted to avoid imposing a solution on Ansys that might not align with their needs. Following a comprehensive evaluation, Pronovix recommended that their partner utilize Hotjar. Acting on this suggestion, Ansys proceeded to enlist Hotjar’s services to gather additional user feedback.

On the right side of the page, users can click on a ‘Feedback’ widget, which opens the rating.

After providing a rating, one can explain their experience via written feedback through Hotjar. This way, Ansys can discover their users’ needs and, based on that, make adjustments if necessary. Hotjar can also be further configured to run separate feedback widgets on different site sections, giving the Ansys team flexibility to respond to newly emerging requirements.

The Ansys developer portal also has the capability to build and configure forms on the portal itself, and display them in various parts of the site. The Ansys team can modify this text, and specify what types of data is collected in the agreement. Submitted form data can be downloaded in various formats and fed into miscellaneous compliance monitoring systems.