Comments (5)
Interesting idea :) A big issue that I see here is that Behat tests are, while very precise, not necessarily easy to read. They serve as specification, so that's fine. Documentation, on the other hand, serves as learning resource. Readability and understandability should be key there. I don't think we can achieve that with Behat tests.
Second, Behat tests require changes to the FeatureContext every time a sentence is reworded. This would slow down work on the documentation considerably.
Apart from this issue, I think that starting to write Behat tests for Sulu is a great idea.
from sulu-docs.
Well, I think (I had to check) the idea of the extension is to embed the behat sentences in the RST file, but they would not be rendered in the documentation. So they are essentially static and invisible.
from sulu-docs.
btw. we are already using Behat to test Sulu Standard, but the tests are quite flaky IIRC due to Husky/JS.
from sulu-docs.
@dantleech Would not even say that this is caused by Husky or JS, I am sure quite often we are not waiting for the right events to happen. If we write at some points only And I wait for a second
it doesn't surprise me that the tests are flaky.
And apart from that it might not even be necessary to test this kind of stuff using behat. We could simply take the commands written, execute all of them, and see if we have a working sulu installation at the end. However, this is probably not as easy as it sounds 😕
from sulu-docs.
On Thu, Mar 10, 2016 at 08:28:58AM -0800, Daniel Rotter wrote:
[1]@dantleech Would not even say that this is caused by Husky or JS, I am
sure quite often we are not waiting for the right events to happen. If we
write at some points only And I wait for a second it doesn't surprise me
that the tests are flaky.
The point is there are no events we can listen to to say "OK" this is
loaded, its very hit-and-miss, and then it is flaky still, for whatever
reason (at least the last time I saw it, which tbh was over half a year
ago).
And apart from that it might not even be necessary to test this kind of
stuff using behat. We could simply take the commands written, execute all
of them, and see if we have a working sulu installation at the end.
However, this is probably not as easy as it sounds [2]:confused:
Behat was just a tool that could be used to execute the generated file.
There are other ways to do it, but all would involve either annotating
the markup or adding a fair amound of regexes in different file.
This is also not about executing (and testing) commands, but also code
snippets and configuration.
from sulu-docs.
Related Issues (20)
- Website/Webspace Security is not well documented
- Add missing SuluMedia Bundle Configurations HOT 6
- Subdomains in Sulu HOT 5
- Add documentation for image format attributes HOT 1
- Redesign Issue list HOT 2
- Discussion: Community Bundles in Doc HOT 4
- Create doc how to integrate a external user provider to create sulu admin user
- The function of the <cacheLifetime> Element is described wrong
- Link Type: enable_target looks like required but it's not HOT 1
- Missing docs for text_line content type
- Improve varnish configuration for user context based caching
- User Guide for Content Managers
- Add documentation for sulu_navigation_is_active Twig function HOT 4
- Missing SuluAdminBundle Documentation
- Support for automated translation tools
- Add example vhost for caddy webserver
- Add hint how fosjsrouting works
- Incorrect documentation on content type Location HOT 1
- Basic information about sitemap is missing
- Missing documentation Webspace Portal configuration - redirect
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from sulu-docs.