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

Missing documentation on unit testing #50

Open
Djei opened this issue Jan 21, 2014 · 5 comments
Open

Missing documentation on unit testing #50

Djei opened this issue Jan 21, 2014 · 5 comments

Comments

@Djei
Copy link

Djei commented Jan 21, 2014

There is currently no ressources in the user manual documenting the unit testing capabilities built around Aria templates.

@jakub-g
Copy link
Collaborator

jakub-g commented Jan 21, 2014

Hello @Djei,

It's true there's no documentation explicitly in the usermanual, it doesn't mean though we don't have any documentation on it. We actually have quite a lot of it, but it's spread in few places.

Here's description of Aria Templates utility classes for testing templates, widgets etc:

http://ariatemplates.github.io/Test-Driven-Development/aria_testcase.html

We're using Attester to test Aria Templates itself, you can set it up to test your code too:

https://github.com/attester/attester
http://attester.ariatemplates.com/map.html

For reference here are our config files:

https://github.com/ariatemplates/ariatemplates/blob/master/test/attester.yml
https://github.com/ariatemplates/ariatemplates/blob/master/package.json#L20

@olaf-k
Copy link

olaf-k commented Jan 27, 2014

This is a recurring comment though, so we should have an entry in the usermanual that, at least, links to the TDD doc (and possibly stuff still hosted on Topspot, to be verified.)

@Djei
Copy link
Author

Djei commented Jan 27, 2014

Thank you for the documentation links.

I think that suggestion from @olaf-k could be a very good short term substitute. Since there are no documentation on the official website, our secondary source of information is usually topspot reference manual. However the material on topspot is sometime outdated and can mislead developers.

@jakub-g
Copy link
Collaborator

jakub-g commented Jan 27, 2014

Agreed with both previous speakers. The documentation on topspot (which is quite outdated though a lot of it is still valid) should be reviewed soon and migrated to http://ariatemplates.github.io/Test-Driven-Development

@jakub-g
Copy link
Collaborator

jakub-g commented Feb 19, 2014

For reference, here is some internal documentation, some of which should be migrated to at.com / at.gh.io:

topspot/index.php/Category:Aria_Templates_Testing

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

No branches or pull requests

4 participants