An article list is a Home view of published articles. A feed is a set of article results returned for a broad reading purpose. A tag is a subject filter that narrows the list to articles carrying that tag. Use a feed when you want a broad set of results, or use a tag when you are looking for a particular subject.
| If you need to… | Go to |
|---|---|
| Browse the public article list | Open the Home article list |
| Read articles from your feed | Choose a feed or tag |
| Narrow the list by subject | Choose a feed or tag |
| Move through more than one page of results | Handle different result sets |
| Open an article or visit its author | Continue from an article result |
| Favorite an article | Favorite articles |
Before you start
Home is a browsing surface, so you do not enter article details there. The list is chosen from the available feeds or tags, and pagination appears only for a result set containing more than 10 articles.
Prerequisites
- Know whether you need the public list or the list available after you sign in.
- Have a subject in mind if you plan to filter by tag.
- If you expect page numbers, work with a result set containing more than 10 articles.
Open the Home article list
Open / to reach Home, the article-list entry point. It brings together tags, article
results, and the feed choices used to narrow those results.
Prerequisites
- Know whether you want the public article list or a signed-in feed.
Steps
- Open the Home route at
/. - Locate the feed choices above the article results.
Result: Home is open with the article-list area and its available feed choices.
Understand the article-list surface
The article-list surface groups feed choices, tags, article results, and page navigation in one place. A selected tag appears as its own active tab, while the article area can show loading or empty-list messages.
| Area | What to look for |
|---|---|
| Feed choices | Your Feed appears when an authenticated token is present. Global Feed is available without that guard. |
| Tag area | Tag links appear when tags have loaded. Selecting one adds an active tag tab. |
| Article results | Article rows contain an author link, a date, a favorite control, a title, a description, a Read more... link, and tags. |
| Page navigation | Page numbers appear only when the article count is greater than 10. |
| Loading and empty states | The article area can show Loading... or No articles are here... yet.. The tag area can show Loading Tags.... |
The favorite control is a heart icon beside the article's favorite count.
Choose a feed or tag
Choose a feed or tag according to your reading goal.
Prerequisites
- Have Home open.
Steps
-
Choose the list that matches what you want to read.
If you want to… Select Read the public article list Global Feed Read the feed available to your signed-in account Your Feed Narrow the results to a subject The tag value for that subject -
Confirm that the selected results replace the loading state.
-
If you selected a tag, confirm that the selected tag appears as the active tab.
Result: The article list matches the feed or tag you selected.
Handle different result sets
The list changes according to your sign-in state, the selected tag, and the number of matching articles. Use the branch that matches what you see.
| What you see | What to do |
|---|---|
| Your Feed is available | Select Your Feed to request the authenticated feed. |
| Your Feed is unavailable | Select Global Feed for the public article list. |
| A tag is selected | Continue with the active tag tab and its filtered results. |
| No tag is selected | Choose a tag value from the tag area if you need a subject filter. |
| Page numbers are present | Select the page number for the next result set. |
| Page numbers are absent | Continue with the current result set. Pagination is not shown for 10 or fewer articles. |
The initial list uses the feed when a token exists and the global list otherwise. Global and tagged lists use 10 articles per request, and the feed request starts with 10 articles.
Prerequisites
- Have an article list open.
- Use a result set with more than 10 articles to move to another page.
Steps
- In the pagination area, select the page number you want to open.
- Confirm that the selected page results appear.
Result: The selected page of article results is on screen.
When the list does not give you a result
The Home list uses exact messages for loading and empty results. Use the message on screen to choose the next action.
| Message | What it means |
|---|---|
Loading... | Article data is not ready for display. |
Loading Tags... | Tag data is not ready for display. |
No articles are here... yet. | The selected list contains no articles to display. |
Prerequisites
- Have Home open with the message visible.
Steps
-
Check which message appears and follow its action.
If you see… Select or do… Loading...Wait for the article area to finish loading. Loading Tags...Wait for the tag area to finish loading. No articles are here... yet.Select Global Feed or choose another available tag. -
Confirm that the resulting article list or loading state matches the message action.
Result: The article area is either loading, shows its available results, or is ready for you to choose another feed or tag.
Continue from an article result
An article result gives you three onward actions: open the article, open its author's profile, or change the article's favorite state.
Prerequisites
- Have an article result on screen.
Steps
-
Select the action that matches what you want to do.
If you want to… Select Open the article The article title or Read more... Visit the author's profile The author's name Toggle the article's favorite state The heart icon beside the article's favorite count
Result: The selected article, author profile, or favorite action is open for the next task.
Continue with Read and manage an article, View a profile, or Favorite articles.
Was this page helpful?