Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

learn.adafruit.com: PyPortal Categorisation enhancement #954

Open
aioue opened this issue May 14, 2022 · 0 comments
Open

learn.adafruit.com: PyPortal Categorisation enhancement #954

aioue opened this issue May 14, 2022 · 0 comments

Comments

@aioue
Copy link

aioue commented May 14, 2022

Thank you for your website and products. I'm a happy user with an enhancement request:

Add a 'PyPortal' category to learn.adafruit.com, to ensure PyPortal products are '1st class citizens', just like Circuit Playground products are.

Motivation: as a new user, PyPortals were much harder to start using than Circuit Playgrounds, as the Learn examples were less easy to find.

This simple proposal makes PyPortal documentation easier to discover 🔍

Background: Circuit Playground

Circuit Playgrounds are a 'main feature' on learn.adafruit.com.

As a main feature, Circuit Playground products have a great main category page in the Learn area.

On that page, you can see all the available Learn articles, and also see the sub-categories for the Circuit Playground product variants (Bluefruit, Classic, and Express).

Here is a screenshot of the main Circuit Playground Category Page. Have circled the sub-category links:

circuit-plaground-main-category-page

This useful categorisation extends to learn articles - they are all usefully tagged, and make it easy to find more Circuit Playground tagged learn articles from within each existing article.

Here is a screenshot of the Circuit Playground Express Product Page, have highlighted the Circuit Playground category and Express sub-category links:

circuit-playground-subcategory-links

This makes discovering use cases and code very easy, great!

Background: PyPortal

Currently the Primary Guide linked from the product page for the PyPortal only lists the PyPortal under the IoT category.

pyportal-subcategory-links

This makes discovering and learning about the PyPortals much harder than the Playgrounds.

Proposal

Make PyPortals a 'main feature' in learn.adafruit.com.

Just like Circuit Playground:

1. Add a main Category jump page for the PyPortal line of products.
2. Add sub-categories for the PyPortal variants (Classic, Pynt, and Titano)
3. Tag existing Learn articles with these new categories

This will encourage more Learn articles, helping newbies out (and hopefully sell more units).

I'd like to support this change any way I can - for example, by going through all the existing learn links one-by-one and finding which ones should be tagged with PyPortal Category, and Classic, Pynt, and Titano Sub-Categories.

Thank you very much for your time and consideration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant