Page MenuHomePhabricator

Review developer portals of other organizations and companies
Closed, ResolvedPublic

Description

...especially those who also have a broader variety of products, technologies, and languages.

Helpful to get an idea how to structure content, categories, UX, discoverability.

Random link collection (not necessarily all relevant, and not much sorted):

Further references:

Event Timeline

Aklapper triaged this task as Lowest priority.Aug 21 2020, 12:05 PM
Aklapper created this task.
Aklapper moved this task from Inbox to 2021-Q2 on the Wikimedia-Developer-Portal board.
Aklapper claimed this task.

Dropping my notes. (Thanks to Alex and Sarah for taking an initial shared look at three sites together.)

This was a useful exercise to get an idea for clustering categories/use cases/tech areas in T260989.
Some of this could also become handy for T261509: Sort out navigation concept at some future point.

Main content sections

https://www.adobe.io/Explore our APIs ⸱ Why build with Adobe ⸱ Integrate with APIs ⸱ Developer Console ⸱ Watch sessions ⸱ Build for Creative Cloud ⸱ Build engaging document experiences ⸱ Build Cloud Apps ⸱ Get started building (list of products)
https://developer.amazon.com/Alexa ⸱ Amazon Appstore ⸱ Amazon Dash ⸱ AWS Developer Center
https://developers.facebook.com/Developer Tools (products mixed with tech areas) ⸱ Discover programs ⸱ Latest news
https://developers.google.com/Products ⸱ Events ⸱ Communities ⸱ News ⸱ Find a developer expert
https://developer.ibm.com/Technology Topics ⸱ What's Trending ⸱ Call for Code ⸱ Code Patterns ⸱ Tutorials ⸱ Videos ⸱ Articles ⸱ APIs & SDKs ⸱ Events ⸱ Industries
https://developer.microsoft.com/Products/Services/Tools ⸱ Start building (Web, AI, Games, apps, ML, ...) ⸱ Discover (Code samples, Docs, Learn) ⸱ Connect (Community, Events, Get Help, Blogs, etc)
https://developer.mozilla.org/Web Technologies ⸱ Learn Web Development ⸱ Developer Tools ⸱⸱⸱ Blog entries ⸱ Help improve docs
https://developer.wordpress.org/Code Reference ⸱ Coding Standards ⸱ Block Editor ⸱ Common APIs ⸱ Themes ⸱ Plugins ⸱ REST API ⸱ WP-CLI ⸱ More Resources ⸱ Contribute ⸱ Need Help?
https://developer.fedoraproject.org/Start a project ⸱ Get tools ⸱ Languages & databases ⸱ Deploy and distribute ⸱ News
https://www.drupal.org/developersDownload ⸱ Browse code ⸱ Get started (Dev Guide) ⸱ By Industry ⸱
https://documentation.platformos.com/Get started ⸱ Dev guide ⸱ API Ref ⸱ Best practices ⸱ Use cases ⸱ Release notes ⸱ Community ⸱ Get involved

Top bar navigation items

Site⍔?Content
https://www.adobe.io/🗶Discover ⸱ Open Source ⸱ Blog ⸱ Console
https://developer.amazon.com/🗶Alexa ⸱ Amazon Appstore ⸱ AWS ⸱ Docs
https://developers.facebook.com/🗸🗶Products ⸱ Programs ⸱ Docs ⸱ More
https://developers.google.com/🗸🗶Products ⸱ Events ⸱ Learn ⸱ Dev Communities ⸱ Blog
https://developer.ibm.com/🗸Topics ⸱ Products & Services ⸱ Community ⸱ Open source at IBM
https://developer.microsoft.com/🗶Documentation ⸱ Learn ⸱ Q&A ⸱ Videos ⸱ Code Samples
https://developer.mozilla.org/🗸Technologies ⸱ References & Guides ⸱ Feedback
https://developer.wordpress.org/🗸🗶Showcase ⸱ Learn ⸱ Themes ⸱ Plugins ⸱ Mobile ⸱ Support ⸱ Get Involved ⸱ About ⸱ Blog ⸱ Hosting ⸱ Get WordPress
https://developer.fedoraproject.org/🗶same as main content sections
https://www.drupal.org/developers🗶Why Drupal? ⸱ Build ⸱ Solutions ⸱ Services ⸱ Community ⸱ Resources ⸱ Give ⸱ Events ⸱ Try Drupal
https://documentation.platformos.com/🗶same as main content sections

⍔ = dropdowns

Search field element

⊙ = centered, dominant; ↗ = upper corner

Second-class navigation elements at bottom

https://www.adobe.io/APIs and Services ⸱ Community ⸱ Support ⸱ Adobe Developer
https://developer.amazon.com/Terms & Agreements ⸱ Amazon Appstore ⸱ Alexa ⸱ Services & APIs ⸱ Blogs ⸱ Support
https://developers.facebook.com/Products ⸱ Programs ⸱ Support ⸱ News
https://developers.google.com/Connect (Social Media) ⸱ Programs ⸱ Developer consoles
https://developer.ibm.com/IBM Developer ⸱ Follow Us ⸱ Explore ⸱ Select a (human) language
https://developer.microsoft.com/🗶
https://developer.mozilla.org/Web Technologies ⸱ Learn Web Development ⸱ About MDN ⸱ Feedback ⸱ About ⸱ MDN Web Docs Store ⸱ Contact Us ⸱ Firefox
https://developer.wordpress.org/About ⸱ Blog ⸱ Hosting ⸱ Donate ⸱ Support ⸱ Developers ⸱ Get Involved ⸱ Learn ⸱ Showcase ⸱ Plugins ⸱ Themes ⸱ (Websites) ⸱ (Social Media)
https://developer.fedoraproject.org/About ⸱ Download ⸱ Support ⸱ Join
https://www.drupal.org/developersNews ⸱ Community ⸱ Documentation ⸱ Download & Extend ⸱ About
https://documentation.platformos.com/Documentation ⸱ Updates ⸱ Discover

Random notes

  • Though browsing on a desktop screen I have not seen a single "side bar" implementation. Might make sense in times of smaller screens.
  • Amazon: Top corner 'question mark' dropdown for: Support ⸱ Docs ⸱ Forums ⸱ Contact Us
  • GitLab: No developer portal exists yet for GitLab itself - see https://gitlab.com/groups/gitlab-org/-/epics/2177
  • Google: Main content section: Light on language; products have no descs so you need to know already, products only most popular/used with link to list of all. "News" are articles.
  • IBM: Dark initial viewport and lots of scrolling and navigation - IMHO rather confusing
  • IBM: "Site feedback" on the side, interesting style
  • Microsoft: ''Documentation'' portal is separate from developer portal (might apply to more sites)
  • PlatformOS: "Was this page helpful" gadget (might apply to more sites)
  • Wordpress: Main content section: Technologies/areas as heading, then related actions (verbs) as short text below
  • Amazon, Fedora: Quite minimalistic