JokesOnYou

Check out the WIKI!!!!!

About Learning

• We formed this project to learn about web development using C# as main Language.
• We will create a website where people can view and rate jokes.
• This should be a learning project for all aspects. The Building, Coding, Documenting and Teaching.

About project

• Jokes on you is a text based reddit like jokes website (No Memes YET!).
• Users can add their own Jokes.
• Users can then Vote the joke up and down.
• Users can sort jokes and will get to see different jokes every time they visit.
• Users can vote on and create Tags for jokes by which the jokes can be sorted.
• Users can be Flagged because they violated a rule, by posting "bad" Joke or "bad" Tag.

Summary

• Getting Started
• How to Discord
• Running the tests
• Deployment
• Built With
• Contributing
• Versioning
• License
• Acknowledgments

Getting Started

Prerequisites

1. Any type of IDE:

• Visual Studio 2019
• Visual Studio Code
• Discord

2. Join the Code Together Discord Group : Join Here

Follow this:

1. Clone the project from this page to your pc.
2. Use the IDE you prefer Visual studio 2019 or Visual studio code should work best.
3. Pick an issue from the list of issues in the project.
   

• The sprint is the issues we would like to get finished before the end of the sprint.
• Backlog are items that need to be done sometime (now or in the future)
• Backlog is where all new issues (if assigned to the project will start in)

4. Assign yourself as Assignee.
5. Move the card into In Progress
6. In your IDE or Git manager create a new branch based of dev
7. Name it as discussed in the wiki page How To BackLog
8. Start working on it!
9. When done with working for the day push your branch to the github. (so other people might continue where you left off)
10. When done with the branch Merge dev into your branch so you have the most updated version of dev.
11. Then make a Pull-Request (PR) and make sure you target dev branch.

Installing

Server Environment

1. To view the database you can use the object explorer inside Visual studio. Press View -> SQL server object explorer

• If you prefer to use SQL Server Management Studio use this connection string to connect to the database: (localdb)\MSSQLLocalDB

2. Download Postman or create an account to run it in your browser.

• Set up environment variables in Postman.
• The base URL will be http://localhost:8000/api.
• A bearer token is needed to make authorised http requests. You can generate a token at the /account/login endpoint.
• Pass the bearer token to a request.

Client Environment

• The client side uses Angular. See Client README.md for setup instructions.
• The server environment needs to be running before you can launch the client server.

How to Discord

1. Join the Discord Server
2. There ask to join the group building the Jokes On You Website
3. You will be invited and see the following channels:

• Announcements Here these rules will be posted and you will find information.

• Funchat is for your everything conversation. small questions, discussions, ask for help here.

• projectfun is where important information goes. please don't talk here or discuss here we try to keep it clean.

• fungithub Github posts everything changed to github in this channel, Good Bot!

• standup

  • Want to work on something?
  • need help with something?
  • want to work together on something?
  • Made something?
  • Need a PR review?

  Please Post here!

• Hello Say Hello here please add

  • from which timezone you are so we can add it to the list and you can Pair-code with people from your timezone.
  • What you hope to learn from this project.
  • what you would like to learn.
  • what you already know.

  PLEASE KEEP CHATS IN THE CORRECT CHANNELS!

Running the tests

Explain how to run the automated tests for this system

Deployment

Explain how to deploy this on a live system

Built With

• .Net Core 5
• Asp.Net Core
• SQLite
• Entity Framework Core (EF)
• Xunit
• Angular

Contributing

Do you see something that you think:
- Should be different.
- Has a better way of beeing done.
- needs more.
- needs less.
- or needs refactoring.

We are a Learning community and we love to hear about it!

• Reach out on Discord.
• Start an issue in the project.
• start discussing with us here in the project discussions.
• give tips

place link to CONTRIBUTING.md

Versioning

Every sprint will be for 1-2 weeks. we will review what we made and how it fits in the project. everyone is welcome to join in and discuss.

License

Acknowledgements