Commit 2255097d by Rex Zhou

readme

parent 025dfe8a
Showing with 11 additions and 5 deletions
#README
## Table of Contents
1. [Usage](# Usage)
2. [easy/hard](## What you thought would be hard but was easy, and what you thought would be easy but turned out hard?)
3. [Third Example](# Proudest Thing)
##Usage
### Backend
......@@ -25,13 +31,13 @@ npm install --save bootstrap
Then run `npm start`, will automatically open browser in `localhost: 3000`.
##What you thought would be hard but was easy, and what you thought would be easy but turned out hard?
## What you thought would be hard but was easy, and what you thought would be easy but turned out hard?
Realtime bidding seemed hard in the beginning as none of us has any experience in large-scale web service, let alone realtime communication and concurrencies. It turned out that, by using a websocket, server-client interaction can be largely simplified as exposing port to clients, handshaking, and exchanging messages.
As for things turned out not so easy, we found collaboration in developement, distributing tasks, merging codes, tracking issues and publishing changes surprisingly hard. Often time, we found ourselves lost in communication -- either having different version of code or having different understanding in the agreed APIs. To solve the problem, we have spent extra time setting up development tools like Trello, Git, Maven, and NPM. In the end, we believe the extra work actually facilitated our development cycle.\
##Proudest Thing
## Proudest Thing
During the time we worked on the project, we feel like a software engineer, and that is the proudest thing in this project. We solved problems like a software engineer and we work together like software engineers.
......@@ -39,13 +45,13 @@ The way of feeling like a software engineer is not just getting better in coding
We started the project all over. Design system, created database, implemented frontend, all the thing, and in order to make all parts work like a thing together we had to solve every single bug. At the end of the quarter, we are able to deliver a good result, and see that all functions we implemented do work, at that time, we feel awesome.
##Things can improve if we have more time
## Things can improve if we have more time
As Steve Jobs said, you have got to start with the customer experiment and work back toward the technology - not the other way around.
The user experiences is crucial in an online application, and we think we can do better if we have more time. Such as internal message, like if buyer want to have a conversation with a seller, or asking a help from auction service; recommendation system that can help buyer find what they really need, and offer an appropriate price for sellers’ item etc.
##Pain Points (technical and organizational)
## Pain Points (technical and organizational)
When we are designing and developing the project, we found actually writing the code is rarely the cause of pain (actually it’s quite enjoyable!). Because we already know the logic to use and depending on the stack we can either code from memory or look up the syntax we need on demand. Well we found other 4 pain points that are:
......@@ -61,7 +67,7 @@ When we are designing and developing the project, we found actually writing the
4. Testing
- From basic unit testing to end-to-end testing for whatever reason this is painful for developers largely because it's a bit mundane and it's almost always under appreciated by the client or project stakeholders.
##Value of Design - Code - Refactor
## Value of Design - Code - Refactor
1. getting a quick picture of the important entities in a system
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or sign in to comment