Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

api doc generator #1784

Merged
merged 18 commits into from
Jan 6, 2014
Merged

api doc generator #1784

merged 18 commits into from
Jan 6, 2014

Conversation

cebe
Copy link
Member

@cebe cebe commented Jan 5, 2014

This is an early draft of the api doc generator implementation.

TODO:

  • finsh the model layer to hold all information we need.
  • add all information to the offline template
  • add command runner bin file
  • make templates exchangeable
  • markdown support
  • resolve links with non fqNames (for doc types this is already done by phpDocumentor :-) )
  • resolve class internal links
  • complete support for Objects property feature
  • polish and cleanup
  • display arrays in short syntax
  • README file

fixes #62

depends on phpDocumentor/Reflection#16 to be merged.

cebe added 17 commits January 5, 2014 03:19
* master: (27 commits)
  fixed div/0 issue in console progress bar
  console HelpController use correct script name
  support table aliases for ActiveQuery::joinWith().
  guides fixed/improved
  CS fix
  improved fixture controller
  Added back border to debugger toolbar.
  #1788 info about retaining the default scenario
  fixes #1606
  Default name and title added to GitHub auth client.
  added classes to grid, list and detail view
  fixed basic app travis
  debugging travis
  debugging travis
  added debug toolbar background to have line separators
  fixed paths in travis.yml
  reverted 1e4c1ec to get a working debug toolbar
  fixed issue with too long th columns in debugger
  enabled acceptance tests for basic application
  run basic app functional tests within the main repo test chain
  ...
@cebe cebe mentioned this pull request Jan 6, 2014
7 tasks
@cebe
Copy link
Member Author

cebe commented Jan 6, 2014

done. ready for review.

@qiangxue
Copy link
Member

qiangxue commented Jan 6, 2014

It looks great to me! Do you have some example screenshots or Web pages that we can take a look?

@cebe
Copy link
Member Author

cebe commented Jan 6, 2014

screenshot-2014-01-06t05 50 04

Uploaded the framework docs to my server: http://stuff.cebe.cc/yii2docs/
The template is copied and adjusted from the yii 1.1 api generator so it looks not as fresh as it could ;-).

@cebe
Copy link
Member Author

cebe commented Jan 6, 2014

Here are docs for the extensions: http://stuff.cebe.cc/yii2docs-extensions/

qiangxue added a commit that referenced this pull request Jan 6, 2014
@qiangxue qiangxue merged commit 52c9256 into master Jan 6, 2014
@cebe cebe deleted the api-doc-generator branch January 6, 2014 05:07
@Ragazzo
Copy link
Contributor

Ragazzo commented Jan 6, 2014

@cebe did detail info of method works? for example when i click http://stuff.cebe.cc/yii2docs-extensions/yii_apidoc_models_basedoc.html#loadSource()-detail there is no some div with method code below or anywhere. Is it supported or i misunderstand what api-generator is? :)

@cebe
Copy link
Member Author

cebe commented Jan 6, 2014

yeah, the extension docs are not complete because core framework classes are missing there.

@Ragazzo
Copy link
Contributor

Ragazzo commented Jan 6, 2014

k, so after it will be all done there will be toggle button with method code/source?

@cebe
Copy link
Member Author

cebe commented Jan 6, 2014

yes, just like it is in current api docs: http://www.yiiframework.com/doc/api/1.1/CApplication#getBasePath-detail

@cebe
Copy link
Member Author

cebe commented Jan 6, 2014

Updated the extensions api doc. they now contain all necessary files.

@Ragazzo
Copy link
Contributor

Ragazzo commented Jan 6, 2014

good, but detailed code still not working, but anyway... we can live with it :)

@cebe
Copy link
Member Author

cebe commented Jan 6, 2014

What is not working? Source Code view is not implemented yet, but links between methods and properties should work. If you find bugs, please show them.

@Ragazzo
Copy link
Contributor

Ragazzo commented Jan 6, 2014

Source Code view is not implemented yet

sorry, thought your comment was about it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Implement API documentation generator
3 participants