Skip to content
D
Documentation

What can you do with Conduit

reference
6 min readUpdated

Conduit is a social blogging site where you can browse articles, publish and manage your own articles, comment on articles, follow other users, and favorite articles.

What you can do with Conduit

Use Conduit according to the work you need to complete:

If you need to…Go to
Understand what Conduit isWhat is Conduit
Understand who uses ConduitWho uses Conduit
Sign in or create accessYour first day, Sign in, or Sign up
Browse articles and tagsFind articles
Create or change an articleCreate and edit articles
Read or manage one articleRead and manage an article
Favorite an articleFavorite articles
Add a commentComment on articles
View or update a profileProfiles overview, View a profile, or Personalizing your workspace
Follow another userFollow other users
View a user's favoritesView favorited articles
Find your way around the applicationUnderstanding the interface or Navigation basics
Resolve a problemGeneral error messages or Common issues and solutions

The main areas are Home, the editor, an article, a profile, and a profile's favorites list. A profile is a user's public information and article lists. The header provides links for the areas available to you. The Home screen provides article feeds and popular tags, while a profile separates a user's articles from that user's favorited articles.

Before you start

Prerequisites

Before you need to…Have this in place
Open Your FeedSign in so the feed is available.
Use the signed-out Home viewOpen Home without a sign-in token.
Create or change an articleOpen the editor for a new article or an article you own.
Edit or delete an articleBe the article's author.
Edit your profileOpen your own profile; the profile action leads to Settings.
Follow or unfollow a userOpen another user's profile.
View favorited articlesOpen the profile's favorites route.
Add a commentOpen the article and have the comment text ready.

The editor collects the article title, description, body, and tags. The comment form collects the comment body. No required markers are declared for these fields.

Find the right starting point

Use this procedure when you know what you want to do but have not yet opened the relevant area.

Prerequisites

  • Decide whether you are browsing, writing, reading, commenting, managing a profile, or viewing favorites.

Steps

  1. From the header or current page, select the control that matches your goal.

    If you want to…Select
    Return to the article listsHome
    Start a new articleNew Post
    Change your profileSettings
    Open your own profileThe username and profile picture link in the header
    Sign inSign in
    Create accessSign up
    Browse a signed-in personal listYour Feed
    Browse the general article listGlobal Feed
    Filter by a popular tagA tag under Popular Tags
  2. On a profile, select My Articles or Favorited Articles according to the list you need.

Result: The selected Home view, editor, profile, article list, or favorites list is on screen.

Create and change articles

An article is a post whose title, description, body, and tags you provide for other people to read.

Use this procedure to create a new article or change an article you own.

Prerequisites

  • Sign in before selecting New Post.
  • Open an article you own before selecting Edit Article.

Steps

  1. Select New Post to create an article, or select Edit Article on an article you own.
  2. In Article Title, enter the article title.
  3. In What's this article about?, enter the article description.
  4. In Write your article (in markdown), enter the article body.
  5. In Enter tags, enter a tag.
  6. Press Enter to add the tag to the article.
  7. Select Publish Article.
  8. To remove a tag before publishing, select the close icon beside that tag.
  9. To remove an article you own, select Delete Article.

Result: The article is submitted with its title, description, body, and tag list, or the article is removed when you select Delete Article.

Read and interact with articles

An article list is a set of article previews that you can browse by feed, tag, or page; an article page contains the selected article and its comments.

Use this procedure to choose a list, open an article, comment, and reach a user's favorites.

Prerequisites

  • Open Home to choose a feed, tag, or page.
  • Open an article before posting a comment.

Steps

  1. Select the article list that answers your browsing question.

    If you need to…Select
    Read articles from users you followYour Feed
    Read the general article listGlobal Feed
    Read articles for one tagThe tag under Popular Tags
    Read another page of resultsA page number below the article list
  2. Select an article preview to open the article page.

  3. In Write a comment..., enter the comment text.

  4. Select Post Comment.

  5. On a profile, select Favorited Articles to open that user's favorited article list.

The article preview also has a favorite toggle represented by an icon rather than a stable reader-facing label.

Result: The selected article list or article is on screen, the comment is submitted, or the profile's favorited article list is on screen.

Manage profiles and following

Use your own profile for profile settings, and another user's profile when you want to follow or unfollow that person.

Prerequisites

  • Open a profile from the header or an article author link.
  • Open another user's profile before following or unfollowing that user.

Steps

  1. In the header, select your username and profile picture link to open your profile.

  2. Select Edit Profile Settings when the profile belongs to you.

  3. On another user's profile, select the control for the action you want to take.

    If you want to…Select
    Start following the userFollow followed by the profile username
    Stop following the userUnfollow followed by the profile username
  4. Select My Articles or Favorited Articles to choose the profile's article list.

Result: The profile, Settings, selected article list, or updated follow state is on screen.

When something goes wrong

Conduit displays API or validation errors as a list of dynamic entries. Each entry combines the error key with the corresponding error value.

No literal message text; each rendered item is the dynamic key followed by errors[key].

What you seeWhat it meansWhat to do
A list of error entriesAn API or validation error was returned for the current action.Read the key and value shown in the list, correct the related article or comment input, and submit the action again.
No stable label for the favorite toggleThe favorite control is represented by an icon.Use the article preview's favorite icon rather than a text label.

Know what to do next

Choose the focused page that matches the next action:

Was this page helpful?

Download as PDF
What can you do with Conduit — Conduit (React)