Comments (9)
Agreed on a template before things get unwieldy. I don't have particularly strong opinions on user stories vs use cases in Issue discussion, if ideas are getting bounced back and forth. But if they go into the repo they should ideally follow a consistent format.
I'd ideally like to get our product owner and metadata staff involved in generating our use cases (or user stories) since they have more a more concrete understanding of the history and the 'why'. Having a template would make it much easier to bring them into this process.
from hydra-works.
FWIW, I only did gherkin in #10 because the contributing doc said so. I
understand the sentiment, but I think what we're trying to accomplish might
be more complex than what gherkin can capture coherently (hopefully that
doesn't start a holy war).
In that spirit, though, I do think use cases are critical, and, even more
important, that they be based on real items we're trying to shoehorn into
our systems right now. I've been part of enough (over-)modeling projects
over the years, where imagined complex corner cases get too much attention,
and the result is always difficult and fragile implementations that don't
scale or migrate well.
-Js
Sent via mobile. Please excuse typos, brevity, etc.
On Oct 8, 2014 6:54 PM, "Matthew Critchlow" [email protected]
wrote:
Agreed on a template before things get unwieldy. I don't have particularly
strong opinions on user stories vs use cases in Issue discussion, if ideas
are getting bounced back and forth. But if they go into the repo they
should ideally follow a consistent format.I'd ideally like to get our product owner and metadata staff involved in
generating our use cases (or user stories) since they have more a more
concrete understanding of the history and the 'why'. Having a template
would make bringing them into this process much easier.—
Reply to this email directly or view it on GitHub
#12 (comment)
.
from hydra-works.
No worries, @jpstroop. Based on the projects you've been involved with over the years, would you recommend one format for these over another. I'm flexible and I think your concerns are ones worth keeping in mind.
from hydra-works.
Personally I'm OK with it being somewhat loose at the moment--my only requirements would be a summary (gherkin if you want) and a set of the aforementioned real-world example.
from hydra-works.
That seems reasonable. referencing real-world examples is a key distinction that should probably make its way into CONTRIBUTING as a requirement.
from hydra-works.
Gherkin was not the suggested language, though issue #6 used the language to explain the problem.
from hydra-works.
I found @mjgiarlo usage of bulleted assertions at the end of #14 clearer than gherkin. Perhaps we could each distill our use cases into a set of assertions and then see where they overlap.
from hydra-works.
Can we close this ticket? Are there any action items?
from hydra-works.
The conversation may have migrated elsewhere, but the ultimate result (whether we came up with a template or just started copying each other) is the contents of the use-cases directory in this repo.
from hydra-works.
Related Issues (20)
- Test using Ruby releases 2.5.1 and 2.4.4 HOT 1
- Update README with product owner information
- Try replacing OM with straight Nokogiri HOT 2
- Remove empty source file lib/hydra/works/characterization/fits_mapper.rb
- deprecated plugin/analysis class [solr.TrieIntField] HOT 3
- using ordered_members puts parent-child relationship in both directions HOT 4
- Use CircleCI for continuous integration
- Test against Ruby releases 2.6.3, 2.5.5, and 2.4.6
- Hydra::Works::AddFileToFileSet #find_or_create_file_for_rdf_uri fails to create original_file association
- Switch to Clamby for ClamAV integration HOT 1
- Add support for Ruby 2.7.z releases
- Add support for Rails 6.0.z releases
- Add Circle CI step that fails if branch name is master
- Support Rails 6.1 releases
- Support Ruby 3.0.3 releases HOT 1
- Configure nightly CircleCI test suite executions HOT 1
- Update the gemspec to require MFA for RubyGems releases
- Issue a request for a new Product Owner
- FITS identification "CONFLICT" - Go with majority "identity" value?
- Provide a roadmap for migration into the samvera/hyrax project
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 hydra-works.