Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions _data/topnav.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,14 @@ topnav:
items:
- title: GitHub
external_url: https://github.com/UIU-Developers-Hub
- title: About Us
url: /about.html
- title: Getting Started
url: /getting-started.html
- title: How to Contribute
url: /how-to-contribute.html
- title: Contributors List
url: /contributorsList.html

#Topnav dropdowns
topnav_dropdowns:
Expand Down
20 changes: 20 additions & 0 deletions contributorsList.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: "Contributors List"
keywords: Contributors, Open Source
tags: [contributors, open_source]
permalink: contributorsList.html
hide_sidebar: true

---

# Contributors List

Below are the members who have contributed to UIU Developers Hub Documentation. To add your name, submit a pull request to this file!

---

*This list will be updated automatically via GitHub Actions in the future.*

## Contributors

<!-- Add your name below this line -->
64 changes: 60 additions & 4 deletions index.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,65 @@
---
title: "Starting your Journey as Developer"
keywords: Homepage
tags: [getting_started]
title: "UIU Developers Hub Documentation"
keywords: Homepage, Getting Started
tags: [getting_started, organization]
permalink: index.html
hide_sidebar: true
---

## This is a place holder
# Welcome to UIU Developers Hub

UIU Developers Hub is the official GitHub organization for developers, faculty, and alumni of United International University. This documentation will help you get started, understand our community standards, and make the most of your membership.

## Why This Project Exists: Learning the Development Lifecycle

When you first show interest in becoming a software developer or engineer, understanding the software development lifecycle is essential. The UIU Developers Hub Documentation project is designed to be a practical, hands-on example of how modern development teams work together, communicate, and build real products.

### What You’ll Experience Here

- **Documentation as a Foundation:** Reading and following documentation is a key part of every developer’s journey. This project demonstrates how clear documentation guides contributors and helps teams succeed.
- **Static Site Generators:** We use tools like Jekyll to transform simple markdown files into dynamic, professional websites. This is the same approach used by many open source projects and tech companies to share knowledge and updates.
- **GitHub CI/CD Workflows:** Automated build and deployment pipelines (CI/CD) ensure that changes are reviewed, tested, and published efficiently. You’ll see how your contributions move from code to live website through these workflows.
- **Open Source Collaboration:** By contributing here, you’ll learn how to fork repositories, create branches, submit pull requests, and review code—core skills for any developer.

### Why This Matters for You

Participating in this project helps you:

- Build habits for reading and writing documentation.
- Understand the full development lifecycle, from planning to deployment.
- Gain real-world experience with tools and workflows used by professional teams.
- Prepare to contribute to other open source projects and build your own dynamic web resources, such as news portals or documentation sites.

UIU Developers Hub is your starting point for learning, growing, and making an impact in the world of software development. Every contribution you make here is a step toward mastering the development lifecycle and becoming a confident, collaborative developer.

## About the Organization

UIU Developers Hub is dedicated to fostering collaboration, innovation, and growth among its members. Whether you are a student, faculty, or alumni, you are invited to contribute, mentor, and learn together.

## Getting Started

- **Join the Organization:** Request access via GitHub or contact an admin.
- **Explore Projects:** Browse our repositories and find projects that interest you.
- **Read the Guidelines:** Familiarize yourself with our community standards below.

## Community Guidelines

- **Be Active and Collaborative:** Participate in projects and discussions.
- **Project Transfer Policy:** Transfer ownership of added projects within one week.
- **Discussion Etiquette:** Keep conversations respectful and constructive.
- **Contributing:** Contact main contributors and review project guidelines before contributing.
- **Blogging:** Contribute to our Blog repository after reviewing submission guidelines.

## Member Types

- **Normal Members:** All general guidelines and contribution rules apply.
- **Faculty Members:** Contribution rules are optional; mentoring is encouraged.
- **Alumni Members:** Contribution rules are optional; mentoring is encouraged.

## Welcome Message

> Welcome to UIU Developers Hub! Whether you're a seasoned developer or just starting out, there's a place for you here. We believe in the power of collaboration and innovation. Together, we can tackle challenges, explore new ideas, and create solutions that make a difference. Stay active, engage with your fellow members, and embrace opportunities to learn and share your knowledge.
>
> Thank you for being a part of UIU Developers Hub. We look forward to building great things together!
>
> — [Fatin Shadab](https://github.com/FatinShadab) / UIU Developers Hub Team
14 changes: 14 additions & 0 deletions pages/about.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
title: "About UIU Developers Hub"
keywords: About, Organization, Mission
tags: []
permalink: about.html
folder: pages
hide_sidebar: true
---

# About UIU Developers Hub

UIU Developers Hub (UIUDH) is the official GitHub organization for developers, faculty, and alumni of United International University. Our mission is to foster collaboration, innovation, and growth among all members interested in software development.

Whether you are a student, faculty, or alumni, you are invited to contribute, mentor, and learn together. Explore our projects, participate in discussions, and help build a vibrant developer community.
26 changes: 26 additions & 0 deletions pages/getting-started.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
title: "Getting Started"
keywords: Getting Started, Onboarding
tags: [getting_started, onboarding]
permalink: getting-started.html
folder: pages
hide_sidebar: true
---

# Getting Started with UIU Developers Hub

To join UIU Developers Hub, you must make at least one contribution to an open source project within our organization. This is a requirement to help you understand the development lifecycle and the importance of documentation and collaboration.

## Why is this Required?

- **Learn by Doing:** Making a contribution helps you experience the workflow of real software projects.
- **Understand Documentation:** Reading and following documentation is a key part of development.
- **Build Good Habits:** You’ll learn how to communicate, collaborate, and work with version control.

## Steps to Get Started

1. Read our [How to Contribute](how-to-contribute.md) guide.
2. Add your name to [contributorsList.md](../contributorsList.md) and submit a pull request.
3. Explore other projects and contribute as you grow.

Welcome to the community!
21 changes: 21 additions & 0 deletions pages/how-to-contribute.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: "How to Contribute"
keywords: Contributing, Open Source
tags: [contributing, open_source]
permalink: how-to-contribute.html
folder: pages
hide_sidebar: true
---

# How to Contribute to Open Source Projects

Contributing to open source is a valuable way to learn, collaborate, and make an impact. At UIU Developers Hub, we encourage every member to make their first contribution by following these steps:

1. **Find a Project:** Explore repositories in our organization and choose one that interests you.
2. **Read the Documentation:** Understand the project's purpose, guidelines, and contribution process.
3. **Fork and Clone:** Fork the repository to your account and clone it locally.
4. **Make Changes:** Add your contribution (e.g., your name to the contributors list, fix a bug, add documentation).
5. **Submit a Pull Request:** Push your changes and open a pull request for review.
6. **Engage:** Respond to feedback and collaborate with maintainers.

By contributing, you build real-world skills and become part of a global community of developers.
Loading