Skip to content

Commit 6ecf608

Browse files
Update README
1 parent 35272d4 commit 6ecf608

File tree

3 files changed

+19
-16
lines changed

3 files changed

+19
-16
lines changed

README.md

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,34 @@
11
[![Open Source Love svg2](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
22
[![MIT license](http://img.shields.io/badge/license-MIT-brightgreen.svg)](https://choosealicense.com/licenses/mit/)
3-
[![Website shields.io](https://img.shields.io/website-up-down-green-red/http/shields.io.svg)](https://suse-uiux.gitlab.io/eos-feature-request/)
3+
# User Story
44

5-
# EOS Feature Request
5+
![](./static/user_story.png)
6+
# Introduction
67

7-
# Guideline to develop this site
8+
The goal of **User Story** is to design and present a scalable backend infrastructure that delivers a web interface allowing users to request new features and give feedback in an easy and intuitive way. Users can attach files with their story to explain what they want. The admins can then resolve, close and update the status of these stories. Users can interact with other stories via comments and votes. This can also serve as an efficient feedback and response mechanism which is critical for any organization to improve and make progress. Simply, its a **product management tool**.
89

9-
In the project directory, you can run:
10+
# How it works
1011

11-
### Starting up the project
12+
![](./static/user_story_workflow.png)
13+
14+
# Guidelines for development
15+
### Setting up the project
1216

1317
After cloning this repository you will need to install all the dependencies: `npm i`
1418

15-
There are two options to set up the `backend` for this repository:
19+
User Story uses [this repository](https://github.com/EOS-uiux-Solutions/strapi) as its `backend`. There are two ways to set up the `backend`:
1620

17-
1. If you are planning to work only on the UI/UX of `eos-user-story`, then follow along. Skip to point 2 if you need to setup backend as well. For setting up using `docker`, first make sure you have `docker` & `docker-compose` installed ([Install instructions](https://docs.docker.com/engine/install/)). Next, run `docker-compose up` and wait for the server to start on `http://localhost:1337`. Visit [http://localhost:1337/admin/auth/](http://localhost:1337/admin/auth/) and create the admin user for Strapi. Then set the roles and permissions for the api endpoints. That's it, the backend is up and running. Proceed to the next paragraph for further instructions.
21+
- You can use Docker to setup backend by following [these instructions](https://github.com/EOS-uiux-Solutions/strapi#using-docker) If you are planning to work only on the `frontend` of User Story, then follow along.
1822

19-
2. This repository uses [EOS-uiux-Solutions/strapi](https://github.com/EOS-uiux-Solutions/strapi) as the backend Strapi server. Follow [these](https://github.com/EOS-uiux-Solutions/strapi#how-to-install-it) instructions to set it up.
23+
- You can setup `backend` locally by following [these instructions](https://github.com/EOS-uiux-Solutions/strapi#locally).
2024

21-
After setting up the backend, you need to connect the frontend to the Strapi server. To do this, duplicate the file `src/config.json.template` into a new file called `src/config.json` and replace the content of the variable with your server URL.
25+
If you want to work only on the `frontend` then go to `src/config.json` and change the value of `apiURL` to `https://userstory-strapi.herokuapp.com`.
2226

23-
Then run: `npm start` to run the app in the development mode.
27+
Then run: `npm start` to run the app in development mode.
2428

2529
Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
2630

27-
The page will reload if you make edits.<br />
28-
You will also see any lint errors in the console.
31+
The page will reload if you make edits. You will also see any lint errors in the console.
2932

3033
### JS and SCSS quality assurance
3134

@@ -38,10 +41,10 @@ To make sure your SCSS is compliant run: `npm run test:scss`
3841

3942
`npm run build`
4043

41-
Builds the app for production to the `build` folder.<br />
42-
It correctly bundles React in production mode and optimizes the build for the best performance.
44+
Builds the app for production to the `build` folder. It correctly bundles React in production mode and optimizes the build for the best performance.
4345

4446
The build is minified and the filenames include the hashes.<br />
47+
4548
Your app is ready to be deployed!
4649

4750
See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.
@@ -50,7 +53,7 @@ See the section about [deployment](https://facebook.github.io/create-react-app/d
5053

5154
### Code contributions
5255

53-
1. Open a new or pick an open issue from the issue list and claim it in the comments. Make sure that the issue is confirmed so you don't work on something that will not be approved to be merged.
56+
1. Open a new issue or pick an open issue from the issue list and claim it in the comments. Make sure that the issue is confirmed so you don't work on something that will not be approved to be merged.
5457
2. Make sure you follow our best practices: [refer to our Wiki](https://gitlab.com/SUSE-UIUX/eos/-/wikis/home). You'll find information on writing code, how to name a branch, how we release, etc.
5558
3. Join Slack [optional] to get in touch with the maintainers if you have any doubt: [join slack](http://slack.eosdesignsystem.com/)
5659
4. Make sure you fork the project, cloning it will not give you the right access to open a PR/MR. [How to open a PR in open source](https://gitlab.com/SUSE-UIUX/eos/-/wikis/Basic-git-instructions-for-beginners)
@@ -59,7 +62,7 @@ See the section about [deployment](https://facebook.github.io/create-react-app/d
5962

6063
If you'd like to contribute with design changes, you'll have to do as follows:
6164

62-
1. [Open an issue](https://gitlab.com/SUSE-UIUX/eos-feature-request/-/issues/new)
65+
1. [Open an issue](https://github.com/EOS-uiux-Solutions/user-story/issues/new)
6366
2. Add all relevant information to the issue. Please be as descriptive as possible. Add links to references, images, videos, etc.
6467
3. While working on your design, please make sure you follow our [design guidelines](https://gitlab.com/SUSE-UIUX/eos/wikis/Design-process-and-feedback-gathering).
6568
4. Once the issue is approved by us, it'll be ready to be implemented.

static/user_story.png

58.9 KB
Loading

static/user_story_workflow.png

162 KB
Loading

0 commit comments

Comments
 (0)