Create initial product documentation

[mhaidarhanif]

• Kind: Statement of Work
• Title: Create initial product documentation
• Author: M Haidar Hanif
• Affiliation: Michi
• Date: 2016-03-20
• Version: 0.2

  SOW

  Overview

Clearly explain what the product is and its important features. This also relates to Explain the basic features of Arlin v1 (https://github.com/gunadarma-academy/asde-michi/issues/9) and Explain the must have features of Arlin v1 (https://github.com/gunadarma-academy/asde-michi/issues/11).

Tasks

• [x] Create product.markdown in docs, fill out more details about the product itself. In the beginning, as a simple platform.
• [x] List the most important features, especially how the features behave.

  Deliverables

The Product Documentation is clearly written and include the essentials.

Dependencies

Could be parallel with https://github.com/gunadarma-academy/asde-michi/issues/9 and https://github.com/gunadarma-academy/asde-michi/issues/11.

[rutheodora]

jadi gw ma @ekkyvalent , kemaren setuju pokoke gw bikin aja dulu wireframe nya gimana secara manual, trus nnti si ekky nyoba implementasi lgsung buat tampilannya, naah kalo konten yang mau ada di dalemnya kan bareng2 tuh nentuinnya, gw tadi pas awal buat berdasarkan seluruh fitur final yang kira2 bakal ada di web kita ( sampe ada filter ama search gitu2)

naah tapi td berhubung td @mhaidarh bilang dibikin yang versi awl bgt aja, yaudah gw lagi rombak wireframe.

trus gw buka project. md ternyata alurnya rada beda sama yang ada dipikiran gw. jadi gw bingung mau patokannya ke siapa.

saran dari gw :bagian Features -> Basically Important di project.md, jangan di jelasin detail dulu, soalnya kalo yang gw liat udah kaya bentuk alur kayak dari awal udah login pake dummy gitu2, padahal gw ga naruh log-in di wireframe, butuh nama usernya cuma pas kita mau post doang wakakak

begicuuuu, jadi baiknya gmn nih wireframenya gw buat aja dulu di kertas taruh whatsapp, trus persetujuan kalian yaaa

[rutheodora]

kalo engga dari back-end kasi aja dulu kira2 alur sistem nya kayak gmn atau yang fitur yang udah bisa selain yang kita diskusiin kemaren (posting, username, answer), jadi kalo mmg log in dulu, nnti gw bisa bikin log in nya dari landing / main page

[rutheodora]

ohh iya, satu lagi, menurut gw harus ada halaman khusus buat isi list dari question yang ada, soalnya untuk fitur answer, itu akan lebih baik kalo kita list semua isi pertanyaan (yang pastinya di halaman sendiri, ga efektif kalo satu halaman sama halaman lain) , trus baru klik pertanyaan yang mau di jawab (klik di box atau klik title atau klik button "answer"?) mohon perjelas, kalo gw pasti prefer ke klik box dulu tapi balik lagi ke back-endnya gimana. trus abis klik salah satu pilihan, baru munculin yang kotak2 buat isi jawaban

begicu~

[rutheodora]

mau coba tes gambar di comment dithub

979f1775f1373c1a22d3f7043c2f1c20-d4icict

[mhaidarhanif]

saran dari gw :bagian Features -> Basically Important di project.md, jangan di jelasin detail dulu, soalnya kalo yang gw liat udah kaya bentuk alur kayak dari awal udah login pake dummy gitu2, padahal gw ga naruh log-in di wireframe, butuh nama usernya cuma pas kita mau post doang wakakak

Kalo di situ berarti ada flaw, ntar satu visitor bisa punya banyak username malah.

[mhaidarhanif]

Tentang struktur data, dibahas di https://github.com/gunadarma-academy/asde-michi/issues/10 dan https://github.com/gunadarma-academy/asde-michi/issues/12

Sederhana aja, tiap fitur maksudnya bisa di-set dan di-store. Jadi belum hingga ke experience flow.

[mhaidarhanif]

@rutheodora @ekkyvalent Nah di product.md bisa coba diedit, commit, push yang menurut kalian. Dengan rapi ya.

[mhaidarhanif]

Dari sisi backend yang jelas bisa CRUD udah bawaan dari database-nya.

Jadi untuk UI/UX diserahkan ke @rutheodora @ekkyvalent

[mhaidarhanif]

menurut gw harus ada halaman khusus buat isi list dari question yang ada, soalnya untuk fitur answer, itu akan lebih baik kalo kita list semua isi pertanyaan (yang pastinya di halaman sendiri, ga efektif kalo satu halaman sama halaman lain) , trus baru klik pertanyaan yang mau di jawab (klik di box atau klik title atau klik button "answer"?) mohon perjelas, kalo gw pasti prefer ke klik box dulu tapi balik lagi ke back-endnya gimana. trus abis klik salah satu pilihan, baru munculin yang kotak2 buat isi jawaban

Iya itu betul, secara default visitor/user bisa liat semua questions di landing page.

[mhaidarhanif]

Flow experience seperti Haash saja. Ini contoh jadinya: http://5oopx.haaash.com

Ini sederhananya:

[rutheodora]

Kalo di situ berarti ada flaw, ntar satu visitor bisa punya banyak username malah.

tes quote

[mhaidarhanif]

@rutheodora Screenshot-nya udah gue tambahin.

[rutheodora]

Kalo di situ berarti ada flaw, ntar satu visitor bisa punya banyak username malah

oke kalo gitu ada login dari awal yaaa.

@rutheodora @ekkyvalent Nah di product.md bisa coba diedit, commit, push yang menurut kalian. Dengan rapi ya.

sip, abis dapet persetujuan dari ekky, gw bikin wireframenya di inkscape lalu gw tambahin product.md

Flow experience seperti Haash saja. Ini contoh jadinya: http://5oopx.haaash.com

gw bener2 patokin dari sini aja gapapa nih dar?

[mhaidarhanif]

oke kalo gitu ada login dari awal yaaa.

Iya baru landing udah disuruh login. Terus itu persistent selama masi di browser yang sama.

sip, abis dapet persetujuan dari ekky, gw bikin wireframenya di inkscape lalu gw tambahin product.md

Oke sip

gw bener2 patokin dari sini aja gapapa nih dar?

Up to you all. Kebetulan karena Stack Overflow, Haaash, Ask.fm desainnya udah teruji, bisa jadi patokan utama.

[mhaidarhanif]

@rutheodora Btw sebenarnya gapapa punya versi desain yang complete dengan search, tag, filter. Tapi itu disimpen buat nanti aja di https://github.com/gunadarma-academy/asde-michi/issues/11 karena bahkan fitur awal aja beluman.

[mhaidarhanif]

@rutheodora @ekkyvalent Atau coba karena ini design decision, kalian bisa diskusi dan bandingin ketiga pelopor tersebut, pros and cons.

[rutheodora]

@mhaidarh sip2 soalnya gw biasa bikin wireframe buat prototipe, jdi semua udah ada dari awal, jadi tinggal ngasi penjelasan, fitur yang ini berlum berjalan de el el

[mhaidarhanif]

@rutheodora Nah, untuk yang udah muncul semua di awal atau agak prototype bisa aja abis ini. Kita bakal pake Invision atau sejenis biar bener-bener kerasa real banget.

From http://www.tatvasoft.com/blog/top-12-software-development-methodologies-and-its-advantagesdisadvantages/#anchor2

A prototype methodology is the software development process which allows developers to create only the prototype of the solution to demonstrate its functionality to the clients, and make necessary modifications before developing the actual final solution. The best feature of this methodology is that it solves many issues which often occur in a traditional waterfall model.

Advantages of Prototyping Model:

• When the prototype is shown to the clients, they get a clear understanding and complete 'feel' of the functionality of the software.
• This method significantly reduces the risk of failure, as potential risks can be identified in early stage and moderation steps can be taken quickly.
• The communication between software development team and the client makes very good and conducive environment during the project.
• It helps in requirement gathering and requirement analysis when there is lack of requirement documents

Disadvantages of Prototyping Model:

• Prototyping is usually done at the cost of the developer so, it is should be done using minimal resources otherwise organization’s development cost stretch too much.
• Too much involvement of client is not always favored by the software developer.
• Too many modifications may not good for the project, as it easily disturbs the workflow of the entire software development team.