Step 1: Sign Up and Sign In
Begin by creating your free GitHub account and signing in via your web browser.
- Open https://github.com in your browser.
- Click the “Sign up” button.
- Enter your email, create a username and password, then follow the on-screen prompts.
- Verify your email address to activate your account.
- Sign in with your new credentials.
Step 2: Explore the GitHub Dashboard
The Dashboard is your central hub for navigating repositories, notifications, and activities.
- Click the GitHub logo or “Dashboard” in the top-left corner.
- Review “Your repositories” to see any existing projects.
- Check “Your issues” and “Your pull requests” to monitor tasks and contributions.
- Visit “Explore” (in the top menu) to discover popular repositories, trending topics, and learning resources.
Step 3: Create a New Repository
A repository stores all your project files and version history. You don’t need to write code to use it.
- Click the “+” icon in the top-right corner and select “New repository.”
- Enter a repository name and optional description.
- Choose “Public” or “Private.” Public repositories are visible to everyone; private ones only to you and collaborators you invite.
- Optionally check “Add a README file” to initialize your repository with documentation.
- Click “Create repository.”
Step 4: Upload Files via the Web Interface
Use GitHub’s web UI to add existing documents, images, or other assets.
- Open your repository and click “Add file” → “Upload files.”
- Drag and drop files or click to browse your computer.
- Review the file list and scroll down to “Commit changes.”
- Enter a commit message like “Add project documents.”
- Click “Commit changes” to upload.
Step 5: Create and Edit Files in the Browser
Create or update text-based files (Markdown, text, CSV) without any local tools.
- In your repo, click “Add file” → “Create new file.”
- Type the filename (for example,
README.md
).
- Use the built-in editor to write or paste content.
- Preview Markdown by switching to the “Preview” tab.
- Scroll down, enter a commit message, and click “Commit new file.”
# Project Title
A brief description of the project and its purpose.
Step 6: Track Work with Issues and Discussions
Use Issues to log tasks, feature requests, or bugs. Discussions let you have ongoing conversations.
- Click the “Issues” tab in your repository.
- Click “New issue,” enter a title and description, then submit.
- Assign labels, milestones, or assignees to organize work.
- Use the “Discussions” tab to start general Q&A or brainstorming threads.
- Follow, comment, or close issues as progress is made.
Step 7: Organize with Project Boards
Project boards provide Kanban-style workflows to visualize progress.
- Go to the “Projects” tab and click “New project.”
- Select a template (e.g., Basic Kanban) or start blank.
- Create columns such as “To do,” “In progress,” and “Done.”
- Add cards by linking existing issues or creating notes.
- Drag and drop cards between columns to update status.
Step 8: Document with the Wiki and Share Insights
The Wiki lets you build a knowledge base alongside your code.
- Click the “Wiki” tab in your repository.
- Click “Create the first page.”
- Name your page (e.g., Home) and add content using Markdown.
- Save the page and create additional pages for tutorials, FAQs, or guidelines.
- Use links to connect pages and structure your documentation.