From 696bf0ce3ec8866f6d3a41d6626fbcb03d43cb15 Mon Sep 17 00:00:00 2001 From: MONGCHAW Date: Sat, 23 Aug 2025 18:07:00 +0600 Subject: [PATCH] Placeholder Content for Furthur Editing --- _data/topnav.yml | 8 +++++ contributorsList.md | 20 ++++++++++++ index.md | 64 +++++++++++++++++++++++++++++++++++--- pages/about.md | 14 +++++++++ pages/getting-started.md | 26 ++++++++++++++++ pages/how-to-contribute.md | 21 +++++++++++++ 6 files changed, 149 insertions(+), 4 deletions(-) create mode 100644 contributorsList.md create mode 100644 pages/about.md create mode 100644 pages/getting-started.md create mode 100644 pages/how-to-contribute.md diff --git a/_data/topnav.yml b/_data/topnav.yml index 8941858..b81bff6 100644 --- a/_data/topnav.yml +++ b/_data/topnav.yml @@ -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: diff --git a/contributorsList.md b/contributorsList.md new file mode 100644 index 0000000..9f0dc05 --- /dev/null +++ b/contributorsList.md @@ -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 + + diff --git a/index.md b/index.md index c466771..11c220d 100644 --- a/index.md +++ b/index.md @@ -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 diff --git a/pages/about.md b/pages/about.md new file mode 100644 index 0000000..b569522 --- /dev/null +++ b/pages/about.md @@ -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. \ No newline at end of file diff --git a/pages/getting-started.md b/pages/getting-started.md new file mode 100644 index 0000000..b047a4c --- /dev/null +++ b/pages/getting-started.md @@ -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! diff --git a/pages/how-to-contribute.md b/pages/how-to-contribute.md new file mode 100644 index 0000000..e749eb6 --- /dev/null +++ b/pages/how-to-contribute.md @@ -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.