Giter VIP home page Giter VIP logo

oscakampala.github.io's Introduction

Table of contents

๐Ÿ“œ The Introduction

Gitter License

Open Source Community Kampala is an organisation for open-source lovers, enthusiasts, advocates, and experts within and across Uganda but centered in Kampala with the sole aim of increasing the rate of credible contributions by Ugandan software developers, designers, writers, and everyone involved in the sphere of technology to open source projects both locally and globally, changing the perception the world has of our developers; we are not just users of software tools, we are also Software creators.

You are welcome to our documentation guide; if you are looking to join OSCA-Kampala Chapter and want to learn more about Free and Open Source Software and also want to know how you can make a contribution to any of our projects. Read this documentaion as a guide; Although it is a work in progress, please feel free to contribute and give us feedback to improve it.

To suggest changes, click the GitHub icon on any docs page and make a pull request. If you're not sure how to do that, read our documentation contribution guidelines.

If you need more help, please contact us at [email protected] or join the #documentation channel on our Discord server.

๐Ÿ How to Get Started

To get started in the open source there's a multitude of tools you can use but first of all you will need to know about OSCA Kampala. Read our Introduction section:

๐Ÿ“ฐ Subscribe to OSCA-KLA Newsletter

๐Ÿ’ฌ Where to Ask Questions

Please use our dedicated channels for questions and discussion. Help is much more valuable if it's shared publicly so that more people can benefit from it.

Type Platforms
๐Ÿšจ Bug Reports GitHub Issue Tracker
๐ŸŽ Feature Requests & Ideas GitHub Issue Tracker
๐Ÿ‘ฉโ€๐Ÿ’ป Usage Questions Github Discussions
๐Ÿ—ฏ General Discussion Github Discussions or Gitter Room

๐Ÿ”— Links and Resources

Type Links
๐Ÿ’ผ Documentation Documents
โš’๏ธ Built Tools Made in Uganda
๐Ÿ‘ฉโ€๐Ÿ’ป Contributing CONTRIBUTING.md

โ˜Ž๏ธ How to get in touch

If you need more help, please join our whatsapp group Whatsapp group, Telegram Chat or join our Discord server.

โœจ This spells the end

This project follows the all-contributors specification. Contributions of any kind are welcome!

Creating a docker container image

In order to create a docker container image, you can use the steps below

Clone this repository and navigate into its directory

Ensure you have minikube installed

Run the commands below

minikube start

kubectl get nodes

docker image build -t <dockerhub_username>/small-web-img:0.1 .

You can then be able to upload your image to the hub using the commands below

docker login

docker image push <dockerhub_username>/small-web-img:0.1

Incase you wish to run a the uploaded container image you can do so like below

docker run --rm --name osca_website -p8080:3000 <dockerhub_username>/small-web-img:0.1

Then you are able to check it out on

http://localhost:8080/

Built with.

  • React.js as the front-end library
  • Next.js as the react framework
  • Tailwind css

APIs and Libraries used

Animations

The react-reveal library was used for the animations like those on the home page, for example.

Installation In the command prompt run: npm install react-reveal --save Alternatively you may use yarn: yarn add react-reveal

For more about how the react-reveal library works, you can read its documentation.

oscakampala.github.io's People

Contributors

abeinevincent avatar asuman315 avatar bharmalh avatar hassanbahati avatar kakoozajerry avatar oscakampala avatar piuskevin3 avatar ronnielutalo avatar samsonroyal avatar syfacollins avatar tracynuwagaba avatar trudycyns avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

oscakampala.github.io's Issues

Increase size of youtube embed

Currently the website has a youtube embed of the event that happened last year. We could make it this better by covering a wider span as we have alot of white unused space
Refer to this for inspiration on how we could pull off this
Screenshot from 2023-02-02 17-46-06

This is what we currently have at the website
Screenshot from 2023-02-02 17-49-11

Workflows Error

Checks keep failing unnecessarily when a Pull Request is made & merged. This however isn't related to issues with the Pull Request but an issue you can read more about here. It is causing the Workflows to fail and end with Error: Process completed with exit code 1. Here's a few possible ways to Fix It.
Annotation 2022-08-15 125310

Improve README doc

I have noticed the README still has simple boilerplate text; i would love to update it with better engaging text

Footer coverage

The footer seems to be convering less than full-width of the page. this is as seem from the home page
Screenshot from 2023-01-06 12-23-49

Wouldnt it be better taking full page width??

@SyfaCollins could this be how it was intended in the design?

Typo in Navbar Links

The experience Navbar item has a typo. It is written as "EXPERINCE" instead of "EXPERIENCE"

Screenshot from 2022-08-27 21-30-00

Design Website UI/UX

The design team at Open Source Community Africa has already fully designed a style guide that you can as well reference here. You may as well make use of the chapter's design assets/resources. The goal here is to re-design the User Interface/User Experience(UI/UX) for all the necessary initial OSCA Kampala Website pages, while keeping Simplicity, Usability and Aesthetics in mind.

The output of all this will be used and easily followed by other contributors while working on the original/initial development of the website's layouts in reference to these UI/UX designs.

Ideally, the recommended tool to support easy collaboration is Figma, as other designers may as well easily contribute to these same designs with more creative ideas once the Figma Board link is shared. The official OSCA Kampala Figma Board may be referenced here. In cases where you're more comfortable using other Design tools for example Adobe XD, you may export your designs and import them into Figma. An example of how to do this for Adobe XD can be referenced here. Similarly for other tools, you may try to find out how to do the same with your tool of choice. Your ultimate goal should be to export your designs to the same Figma Board/resource.

Create visibility for projects at OSCA Kampala

OSCA-Kampala-Chapter github organisation has various tools and projects on going... create visibility for these projects.

  • Design a layout a grid layout for to display the projects
  • Add a data structure to store all projects ( we could look at reading from github api to render them dynamically)

Navbar logo disappears on window resize

The OSCA logo in the navbar disappears when resizing the window at a certain viewport size and then suddenly reappears at a smaller viewport size (see GIF below).

navbar-logo-disappears-osca-kampala

Fix Navigation links

Social links at mobile view drawer seem not to have destination links for linkedin, github and twitter
Screenshot from 2023-01-31 01-06-15

Fix typo

<div className='containe md:mx-auto flex-col justify-evenly text-white text-sm absolute w-full p-5 text-center top-[300px] bg- backdrop-blur-sm bg-black/30 rounded-tl-lg rounded-tr-lg rounded-br-lg rounded-bl-lg'>

As you can see above, the first class name was supposed to be container but we have containe

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.