comentariu .Net XML în documentația API




Există o modalitate ușoară de a produce documentația MSDN-stil de ieșire Visual Studio XML?   

Nu sunt pacient suficient pentru a seta un XSLT bun pentru el , pentru că știu că nu sunt prima persoană să traverseze acest pod. 


De asemenea, am încercat înființarea Sandcastle recent, dar într-adevăr a făcut ochii mei cruce. Ori am fost lipsește ceva important în procesul sau este pur și simplu prea implicat.


Știu că cineva acolo are o soluție foarte frumos mort simplu.


Sunt reiterând aici deoarece cred că formatarea mea a făcut ca punctul de bază non-primitoare pentru a citi:



> 
> I-am dat Sandcastle o încercare, dar a avut un timp foarte greu să-l configurați. Ceea ce am într-adevăr în minte este ceva mult mai simplu.
> 
> 
> 


Asta este, dacă nu pur și simplu nu înțeleg procesul de Sandcastle. Se pare ca o mulțime de bagaj suplimentar pentru mine doar pentru a produce ceva frumos pentru testeri pentru a lucra cu.
Cauți Sandcastle


Proiect Pagina: [Sandcastle de presă](http://www.codeplex.com/Sandcastle/Release/ProjectReleases.aspx)


Blog: [Sandcastle Blog](http://blogs.msdn.com/sandcastle/default.aspx)


[NDoc Cod Documentație Generator pentru NET](http://ndoc.sourceforge.net) folosit pentru a fi instrumentul de alegere, dar sprijin a oprit toate , dar.
Mai puțin deasupra capului (fără SĂPUN plic să-și încheie fiecare apel in)


Mai puțin dublarea (HTTP deja reprezintă operațiuni, cum ar fi ȘTERGE, a PUS, pentru a PRIMI, etc. care au, de altfel, să fie reprezentate într-un SĂPUN plic).


Mai standardizate - HTTP operațiuni sunt bine înțelese și să opereze în mod constant. SĂPUN implementari pot obține delicat.


Mai lizibil și testabile (mai greu pentru a testa SĂPUN cu doar un browser).


Don't nevoie pentru a utiliza XML (ei bine, ai un fel de don't pentru SĂPUN, dar nu prea are sens din moment ce ai're deja face parsarea de plic).


Bibliotecile au făcut SĂPUN (un fel de) ușor. Dar sunt abstractizare departe o mulțime de concediere dedesubt, după cum am arătat. da, în teorie, SĂPUN poate trece peste alte transporturi astfel încât să se evite călare pe un strat de a face lucruri similare, dar în realitate doar despre toate SĂPUN munca'll face vreodată este de peste HTTP. Principalele avantaje ale **ASP.net MVC** sunt:


1. Permite controlul complet asupra prestate HTML.
2. Oferă curat separarea preocupărilor(SoC).
3. Permite [Test Driven Development (TDD)](https://en.wikipedia.org/wiki/Test-driven_development).
4. Integrare ușoară cu cadre JavaScript.
5. În urma design de apatrid natura web.
6. Odihnitor url-uri care permite SEO.
7. Nu ViewState și PostBack evenimente


Principalul avantaj al **ASP.net Formularul Web** sunt:


1. Acesta oferă [RAD](https://en.wikipedia.org/wiki/Rapid_application_development) dezvoltarea
2. Ușor model de dezvoltare pentru dezvoltatorii de cei care vin din winform de dezvoltare. nu, pentru a face asta iti trebui un ide ca devc++ sau codeblocks. Am'am avut succes folosind [Mockito](https://github.com/mockito/mockito).


Când am încercat să aflu JMock și EasyMock, am găsit o curbă de învățare pentru a fi un pic abrupt (deși poate că's doar eu).


Îmi place Mockito din cauza naturii sale simple si curate, sintaxa că am fost capabil să înțeleagă destul de repede. Minim sintaxa este conceput pentru a sprijini frecvente cazuri foarte bine, deși de câteva ori am nevoie să fac ceva mai complicat, am găsit ceea ce am vrut a fost susținută și ușor de înțeles.


Aici's o (prescurtată) exemplu de Mockito pagina de start:



```
import static org.mockito.Mockito.*;

List mockedList = mock(List.class);
mockedList.clear();
verify(mockedList).clear();
```

Nu't obține mult mai simplu decât asta.


Singurul dezavantaj major, care mă pot gândi este că nu o't bate joc de metode statice. salut,

nu vreau sa te descurajez, ci doar sa iti prezint lucrurile intr-un mod poate mai diferit, avand tangente cu domeniul.

intai de toate... ceea ce consideri tu ca stii foarte bine, si anume html, de 4 luni, este o amagire. html este doar un mod de a prezenta informatia pe browser. si nimic mai mult. faptul ca stii sa scrii div si input nu inseamna ca stii html. nu te mai intreb ce fel de html stii... 4... 5? ca se complica lucrurile. baniesc (sau sper ca ai auzit macar de css... nici de ala nu te intreb care varianta o stii... 1...2...3... ca sunt mai multe tipuri. iar oricat html ai stii... din pacate nu poti sa faci nimic fara javascript. iar de cativa ani buni fara jquery si poate knockout sau angular sau backbone sau un alt mic framework de javascript. iar asta din pacate e doar pe client. ca pe server, mai este si acolo o luuunga discutie.

asta ar fi pe foarte pe scurt din punct de vedere tehnic... ceea ce stii tu.

acum, ca idee: nimeni in ziua de azi nu mai scrie un joc de la cap la coada. din simplul motiv ca jocurile au ajuns la un nivel atat de complex incat e practic imposibil ca o singura persoana sa scrie un joc: trebuie sa stii sa programezi, trebuie sa stii sa desenezi, trebuie sa fii regizor pentru a face povestea din spate, trebuie sa fii tester pentru a testa jocul, trebuie sa fii arhitect pentru a intelege arhitectura... si la final mai trebuie sa il si vinzi... pur si simplu nu poti sa faci asa ceva.

pentru ca te adresezi unei nevoi si cam atat. este adevarat ca au existat si cateva exceptii: tetris.

acum. la jocuri ma refeream pentru calculator.

insa odata cu mobilele se redeschide ideea in care ai putea sa scrii un joc pe android/iphone/windows phone/tienzen etc. aici este locul in care ai mai putea scrie un joc de unul singur. e adevarat... chiar trebuie sa te chinui... dar inca se poate.

problema mare insa pe device-uri mobile este insa ca e cam haiducie... pur si simplu fiecare si-a dezvoltat sau incearca sa isi dezvolte un sistem propriu de operare pentru a concura cu androidul (cyanogen si altele) care sunt folosite de companiile chinezesti si produc deviceuri destul de puternice la preturi mici... ceea ce ii scoate pe cei mari din joc, precum samsung, lg, etc).

astfel, apple care are un ecosistem propriu al lui a inceput sa fie copiat de microsoft cu seria lumia si inca cateva de la lg, si inca vreo doi, acum se baga tare si samsung sa isi creeze propriul ecosistem (a achizitionat un sistem numit tienzen). apare si mozilla cu un sistem numit firefox os pentru mobile, toti incearca sa fuga de android, dupa cum iti ziceam pentru ca acesta este dat si la companiile chineze. in plus androidul e gratis in reclama, dar in realitate nu e chiar gratis. sunt ceva costuri si cu licentele pe fiecare mobil, dar pentru tine ca utilizator final sunt costuri ascunse in pretul final al telefonului).

sfatul meu este ca daca tot vrei sa inveti, decide-te intai ce vrei sa faci. eu te-as sfatui sa incerci sa faci aplicatii chiar necesare. sa inveti cum se programeaza, sa treci prin ciclul vietii unei aplicatii. as lua de exemplu site-ul asta si as incerca sa il copiez, sa fac unul la fel. poti sa faci orice. dar daca tot investestk energie in asta, atunci macar fa-o sa merite, sa vina si in ban dupa.

sunt doua mari lumi in care poti sa intrii usor: lumea linux/php/java si lumea microsoft/c#. trebuie sa alegi. ambele au foarte multa documentatie de citit. 

python, c++ si c sunt cam moarte. au ramas legenda. e ca si cum inveti la scoala latina. cu adevarat niciodata nu o folosesti.

pascal... fugi. ala deja pute. nu are viitor. de nici o forma. e mort si nu il mai invie nimeni.

deci:

1. alegeti lumea. cu sau fara microsoft.

2. gaseste o aplicatie care sa faca ceva (orice) dar nu joc.

3. apuca-te si fa-o. my 2 cents:

când implementezi un api nu mi se pare logic să “ghicești” ce fel de date primești pe baza inputului primit. de obicei modul de encodare a datelor îl determini folosind una din metodele de mai jos:

trimițând un http header când faci requestul (clientul api-ului) - considerat best prac… Backslash: 



```
input#search_form\:expression {  ///...}
```

* A se vedea, de asemenea, *[Folosind spații de Nume cu CSS](https://msdn.microsoft.com/en-us/library/ms762307(VS.85).aspx)* (MSDN) fiecare document slide poate fi descărcat în pc ca ppt. cât despre filmele de pe youtube, eu am copiat link-urile într-un document word.

de asemenea, am întâlnit la câțiva colegi materiale care m-au inspirat prin extensiile / link-urile / aplicațiile folosite. astfel că am reținut și aceste resurse… pune informatia in orice editor de text (word, notepad, wordpad), iar la centrul de listare poti sa ceri sa-ti aranjeze informatia pe pagina in modul dorit, apoi sa o scoata pe foaie.
textul se aranheaza cel mai bine in word, iar cu putina rabdare poti face asta chiar tu acasa, urmand ca la xerox doar sa-ti scoata informatia pe hartie, la dimensiunea dorita. http://www.exactsoftware.com/docs/docview.aspx?documentid=%7b79a06bfe-8a9e-475f-9e25-381308bd8f97%7d