They have good documentation and examples of applicaoons of their "features", for example leveraging the key value system to extend to any abstract business with data requirements in decentralized fasshion... so we need marketing related documentation to entice managent of azure and the likes.. developers can look at the api documentation.. azure will pick us up no prob
What exactly is "marketing documentation"?
http://emercoin.com/content/EMCDPO.pdfhttp://emercoin.com/EMCDPOThat is just for the name value system.. See how they extrapolate with examples to trigger the readers imagination(marketing).
And then follow it up with a technical writeup
http://emercoin.com/EMCDNS_and_NVSAnd that is for the copy paste code of namecoin.cpp 0,6,3... They took the name system and did documentation on it and made it "sexy".. Appealing to external people out of crypto.
The only innovation here is the ddns which i dont know is custom or copied, and relating it to thr name value system through lookups.
Its more fluid than what we have to a lehman. The migration guid should be less prevalent because newcomers wont care for bts 1.. Perhaps it should be the use cases link instead or, "what is bitshares"? And start talking about the big picture with links to the individual features we offer and within therr the links to tech documentation.. If we create this flow and get lehman to test it out snd repeat back what we want them to learn then its ready to go for azure.
Took me several clicks just now to read what i wanted i was jumpimg around.. With empty space on the side there should be some graphic symbolizing the feature it is talking about.. It will invite readers to stay on the pages that are important... Especially omes describing features..
All we need is for ppl to feel they are educated quickly about what we are about without trying to sound so smart that you need to be an engineer to "get" the idea of bitshares. We want them to say oh ok cool it can do that? What else? Ok cool i dont need the tech details you have sold me, seems like smart ppl behind this one.
The "features" marketing documentation should probably follow the guideline:
1) what problem are we solving? (Think outside of crypto)
2) why current solutions are not sufficient
3) validate that we are capable of solving and extendimgnthe solution with outside thembox thinking (so they will feel as if only we can solve related problems going fwd, basically hand holding)
4) how the feature works roughly for a lehman
5) what else can bitshares do? (Other marketing pages for other features)
Documentation to a project is like unit testing part of development.. It is equally important to the actual features.. If you only have half you wont have many ppl giving a shit especially ones that review it at a higher level to see if its worth more effort to integrate with.