Skip to content
D
Documentation

Who uses Conduit

concept
6 min readUpdated

Conduit is a social blogging site for people who publish articles, read and discuss them, follow other users, and save articles as favorites. A profile is a user's page with their basic information and article lists. A favorite is an article a user has chosen to save.

Who uses Conduit

Choose the activity that matches what you need to do:

If you need to…Go to
Sign in or create an accountAuthentication overview, Sign in, or Sign up
Find your way around the applicationNavigation basics
Read or find articlesArticles overview or Find articles
Follow a profile or browse its articlesProfiles overview, View a profile, or Follow other users
Browse articles someone has favoritedView favorited articles
Write or update an articleCreate and edit articles
Manage an article you authoredRead and manage an article
Post or remove a comment you authoredComment on articles
Change your profileManage your settings
Resolve an error or common problemGeneral error messages or Common issues and solutions

Before you start

You need an account to use signed-in activities such as your feed, publishing, commenting, following, and favoriting. Have your Email, Password, and, when you create an account, Username in front of you.

Prerequisites

  • To sign in, have your Email and Password ready.
  • To create an account, have a Username, Email, and Password ready.
  • To use signed-in controls, sign in first. Conduit authenticates users with JWT.

Note: Your Feed, article authoring, commenting, following, and favoriting are signed-in activities.

Find the activity you need

The header changes according to whether you are signed in. Use the route that matches the activity you want to perform.

Prerequisites

  • Know whether you are signing in, creating an account, reading, writing, or changing your profile.

Steps

  1. Choose the activity you need from this table.
If you want to…Select
Return to the article listsHome
Enter an existing accountSign in
Create an accountSign up
Start a new articleNew Post
Change your profile detailsSettings
End your sessionOr click here to logout.
Open an article from a listRead more...

Result: The selected activity opens.

Read, follow, and favorite articles

Readers use feeds and profiles to find articles. A profile contains the author's articles and a separate list of articles that profile has favorited. Following changes whether the profile is followed; favoriting changes whether an article is marked as a favorite.

Where you areWhat you can find there
Home pageTags, article lists from Your Feed, Global Feed, or a tag, and article-list pagination
Article pageThe article rendered from markdown and its comments section
Profile pageBasic user information and articles created or favorited by that profile

Prerequisites

  • To use Your Feed, sign in.
  • To follow another profile, open that profile rather than your own profile.
  • To browse a profile's saved articles, open its Favorited Articles tab.

Steps

  1. Choose the activity you need from this table.
If you want to…Action
Read articles selected for your accountSelect Your Feed.
Read the global article listSelect Global Feed.
Open an articleSelect Read more... on its preview.
View another user's profileOpen that user's profile.
Follow another userSelect Follow followed by the profile name.
Favorite an articleSelect the button in the article preview that displays the article’s numeric favorite count beside a heart.
Unfavorite an articleSelect the button in the article preview that displays the article’s numeric favorite count beside a heart again.
View authored articlesSelect My Articles.
View favorited articlesSelect Favorited Articles.

Result: The selected feed, article, profile tab, following state, or favorite state appears on screen.

Write articles and discuss them

Authors use the editor to create or update articles. Commenters use the comment form to add a comment to an article; an article or comment author can manage their own content.

Prerequisites

  • Sign in before opening the editor or comment form.
  • For a new article, prepare its title, description, body, and tags.
  • For a comment, prepare the text you want to post.

Steps

  1. Select New Post to open the editor.
  2. Enter the article title in Article Title.
  3. Enter the article description in What's this article about?.
  4. Enter the article body in Write your article (in markdown).
  5. Enter a tag in Enter tags.
  6. Select Publish Article to create the article.
  7. Open an article you authored and select Edit Article to return to the editor.
  8. Select Publish Article to update the article.
  9. Enter your text in Write a comment....
  10. Select Post Comment to submit the comment.
  11. Select the delete icon beside a comment you authored to remove it.
  12. Select Delete Article on an article you authored to remove it.

Result: The article editor, published article, submitted comment, or owned-content action is shown according to the control you selected.

Handle role-based differences

The controls you see depend on whether you are signed in and whether you own the profile, article, or comment you are viewing.

What you are viewingControls you use
Your own profileEdit Profile Settings, My Articles, and Favorited Articles
Another user's profileFollow or Unfollow, My Articles, and Favorited Articles
An article you authoredEdit Article and Delete Article
An article with a comment you authoredThe delete icon beside that comment
An article while signed outSign in or Sign up to add comments
Home while signed inYour Feed and Global Feed

Prerequisites

  • Compare the profile name with your signed-in profile to determine whether it is your own profile.
  • Compare the article author with your signed-in profile before using author actions.
  • Compare the comment author with your signed-in profile before selecting the delete icon beside that comment.

Steps

  1. Open the profile, article, or comment you want to work with.
  2. Select the control shown for your role in the table.

Result: The page presents the controls available for the profile, article, comment, or sign-in state you are using.

When an action does not complete

When an action is unavailable, first check the role and sign-in conditions for that action, then use the matching next step below.

What you seeWhat to checkNext step
Your Feed is unavailableYou are signed outSelect Sign in, then return to Home.
The comment form is unavailableYou are signed outSelect Sign in or Sign up.
Follow controls are unavailableYou opened your own profileOpen another user's profile.
Profile editing is unavailableYou opened another user's profileOpen your own profile and select Edit Profile Settings.
Article editing or deletion is unavailableYou are not the article authorOpen an article you authored.
Comment deletion is unavailableYou are not the comment authorUse the comment author's profile or leave the comment unchanged.

For broader recovery guidance, open General error messages or Common issues and solutions.

Was this page helpful?

Download as PDF
Who uses Conduit — Conduit (React)