# Find articles

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](#open-the-home-article-list) |
| Read articles from your feed | [Choose a feed or tag](#choose-a-feed-or-tag) |
| Narrow the list by subject | [Choose a feed or tag](#choose-a-feed-or-tag) |
| Move through more than one page of results | [Handle different result sets](#handle-different-result-sets) |
| Open an article or visit its author | [Continue from an article result](#continue-from-an-article-result) |
| Favorite an article | [Favorite articles](doc: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**

1. Open the Home route at `/`.
2. 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**

1. 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 |

2. Confirm that the selected results replace the loading state.
3. 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**

1. In the pagination area, select the page number you want to open.
2. 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**

1. 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. |
2. 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**

1. 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](doc:read-and-manage-an-article), [View a
profile](doc:view-a-profile), or [Favorite articles](doc:favorite-articles).