• Save
Dokumentáljunk, de hogyan?
Upcoming SlideShare
Loading in...5
×
 

Dokumentáljunk, de hogyan?

on

  • 422 views

Budapest.js 2012.05.14.

Budapest.js 2012.05.14.

Statistics

Views

Total Views
422
Views on SlideShare
422
Embed Views
0

Actions

Likes
0
Downloads
0
Comments
0

0 Embeds 0

No embeds

Accessibility

Categories

Upload Details

Uploaded via as Microsoft PowerPoint

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

Dokumentáljunk, de hogyan? Dokumentáljunk, de hogyan? Presentation Transcript

  • HTTP://WWW.VIRTUAL-CALL-CENTER.EU/ Dokumentáljunk! De hogyan? Farkas Máté Budapest.js, 2012.05.14.
  • Tematika- Alapelvek- JsDoc toolkit- docco- NaturalDocs
  • http://geekandpoke.typepad.com/geekandpoke/2012/04/the-new-developer.html Miért is? Miért készítsünk forrás szintű dokumentációt? View slide
  • Mindennek az alapja A legfontosabb, hogy a kód „öndokumentált” legyen.http://perro.si/spaghetti-code View slide
  • Mindennek az alapja/** * A difficult, but * frequently used function. * * @param a the first parameter * @param q the second parameter * @returns the result */myClass.doIt = function(a, q) { /* ... */ return result;}
  • Mindennek az alapja<?phpclass TestResource extends Resource { /** * A GET kérés kezelése. * @param Request kérés * @return Response */ function post($request) { //...
  • JsDoc toolkit“JsDoc Toolkit is an application for automatically generating documentation from commented JavaScript source code.” (Michael Mathews)
  • JsDoc toolkitSyntax myFunction MyConstructor MyConstructor#instanceMember MyConstructor.staticMember MyConstructor-innerMember
  • JsDoc toolkit“As of 27 June 2010 the JsDoc Toolkit Version 2 project is no longer accepting any new Feature Request tickets. Any Feature Request tickets submitted after that date will be deleted without comment.”Használják ma is: Google’s ClosureLinter, InteliJ IDEA, Eclipse, SproutCore…
  • docco“Docco is a quick-and- dirty, hundred-line- long, literate-programming- style documentation generator.”Azt mutatja, hogyan működik, nem azt, hogy
  • NaturalDocs“Natural Docs is an open-source documentation generator for multiple programming languages.You document your code in a natural syntax that reads like plain English.”
  • NaturalDocsFunction: MultiplyMultiplies two integers.Parameters: x - The first integer. y - The second integer.Returns: The two integers multiplied together.See Also: <Divide>
  • HTTP://WWW.VIRTUAL-CALL-CENTER.EU/ Kérdések? Farkas Máté Budapest.js, 2012.05.14.
  • LinkekDokumentációs eszközök:http://code.google.com/p/jsdoc-toolkit/http://jashkenas.github.com/docco/http://www.naturaldocs.org/Az előadóról:http://www.virtual-call-center.hu/http://farkas-mate.hu/