Value Flows issueshttps://lab.allmende.io/groups/valueflows/-/issues2024-03-25T18:50:36Zhttps://lab.allmende.io/valueflows/valueflows/-/issues/720uri property, remove or use2024-03-25T18:50:36ZLynn Fosteruri property, remove or useWe've had a vf:uri property in the ttl file for some time, which can appear in any domain. But we've never explicitly included it anywhere else in the doc, and it mostly sits forgotten.
Review and decide if this is useful or not, and r...We've had a vf:uri property in the ttl file for some time, which can appear in any domain. But we've never explicitly included it anywhere else in the doc, and it mostly sits forgotten.
Review and decide if this is useful or not, and remove or include everywhere.1.0.0Lynn FosterLynn Fosterhttps://lab.allmende.io/valueflows/valueflows/-/issues/719Fix broken context.jsonld in examples2024-02-14T16:18:32ZLynn FosterFix broken context.jsonld in examplesIn all the yaml example data, it is using `https://git.io/vf-examples-jsonld-context`. That unpacks to https://raw.githubusercontent.com/valueflows/vf-examples-jsonld-context/master/context.jsonld. Checking git.io, it says it is no lon...In all the yaml example data, it is using `https://git.io/vf-examples-jsonld-context`. That unpacks to https://raw.githubusercontent.com/valueflows/vf-examples-jsonld-context/master/context.jsonld. Checking git.io, it says it is no longer accepting new links to shorten. When we moved from github, we changed the directory structure, and there is an abandoned context.jsonld file here: https://lab.allmende.io/valueflows/support-tools/vf-examples-jsonld-context/-/blob/master/context.jsonld?ref_type=heads. That one didn't get fixed for the new w3id structure, but it doesn't matter. We do have another context.jsonld file here: https://lab.allmende.io/valueflows/valueflows. That got fixed, but it probably isn't being used anywhere, certainly not in the examples.
We need to have only one. We need to add anything else needed for the examples, and cleanup for VF changes. We need to figure out where it should go, see if we can create some kind of more permanent url for it (w3id?). Then fix all the examples.
Adding here to not forget: run all the yaml through the validator.1.0.0-dochttps://lab.allmende.io/valueflows/valueflows/-/issues/716Get rid of multiple domains and time related issues2024-01-19T12:26:06ZRobin VobrubaGet rid of multiple domains and time related issuesThe following three properties all have multiple `rdfs:domains`,
meaning the subject of that property has to be a subclass of at least two things:
1. `time:TemporalEntity` (or `time:Instant` in the case of `vf:hasPointInTime`)
2. one of...The following three properties all have multiple `rdfs:domains`,
meaning the subject of that property has to be a subclass of at least two things:
1. `time:TemporalEntity` (or `time:Instant` in the case of `vf:hasPointInTime`)
2. one of the VF classes listed in the `owl:unionOf`
```turtle
vf:hasBeginning a owl:DatatypeProperty ;
rdfs:label "has beginning"@en ;
rdfs:domain time:TemporalEntity ;
rdfs:domain [ owl:unionOf (vf:Commitment vf:EconomicEvent vf:Intent vf:Proposal vf:Scenario vf:Process) ] ;
rdfs:range xsd:dateTimeStamp ;
vs:term_status "unstable" ;
owl:propertyChainAxiom (time:hasBeginning time:inXSDDateTimeStamp) ;
rdfs:comment "The planned or actual beginning of a flow or process."@en ;
.
vf:hasEnd a owl:DatatypeProperty ;
rdfs:label "has end"@en ;
rdfs:domain time:TemporalEntity ;
rdfs:domain [ owl:unionOf (vf:Commitment vf:EconomicEvent vf:Intent vf:Proposal vf:Scenario vf:Process) ] ;
rdfs:range xsd:dateTimeStamp ;
vs:term_status "unstable" ;
owl:propertyChainAxiom (time:hasEnd time:inXSDDateTimeStamp) ;
rdfs:comment "The planned or actual end of a flow or process."@en ;
.
vf:hasPointInTime a owl:DatatypeProperty ;
rdfs:label "has point in time"@en ;
rdfs:domain time:Instant ;
rdfs:domain [ owl:unionOf (vf:Commitment vf:EconomicEvent vf:Intent) ] ;
rdfs:range xsd:dateTimeStamp ;
vs:term_status "unstable" ;
owl:propertyChainAxiom (time:hasEnd time:inXSDDateTimeStamp) ;
rdfs:comment "The planned or actual time of a flow; can be used instead of hasBeginning and hasEnd, if so, hasBeginning and hasEnd should be able to be returned with this value."@en ;
.
```
I would say, that this is quite uncommon, and I just tried to load it into a visual editor (<https://app.gra.fo>) that does not support it.
I checked the time ontology (<http://www.w3.org/2006/time>), and looking at `:Instant` and `:TemporalEntity`, I am pretty sure they are used wrong here in VF. VF uses them as "A subject that has a time (instant or interval)", but really it means "a time (instant or interval)",
so for example, a `vf:Commitment` is not a time-interval, or say, there is no thing that is at the same time a time and a vf:committment, but rather there are commitments that have an assigned time. So `time:Instant`, `time:Interval` and `time:TemporalEntity` should rather be used as the range, not as the domain. Then of course, we would have multiple ranges, so .. still an issue in my specific case, but less wrong already.
Also though, it seems to me like all of them would need to use `time:Instant`, not `time:TemporalEntity`, as they are all instants, no time ranges. If `vf:hasEnd` and `vf:hasBeginning` would be allowed to be ranges as well, then the second range (`xsd:dateTimeStamp`) for them would be an issue again.
-> in short: This needs rethinking, I think.1.0.0https://lab.allmende.io/valueflows/valueflows/-/issues/714Upgrade Concepts section2024-02-10T17:00:19ZLynn FosterUpgrade Concepts sectionIt is OK, but some parts are better than others. Follow on to upgrading the Introduction section a few months ago. Consider some diagrams which could be consistent for all the pages there. And other ways they would be more consistent,...It is OK, but some parts are better than others. Follow on to upgrading the Introduction section a few months ago. Consider some diagrams which could be consistent for all the pages there. And other ways they would be more consistent, and also reference other sections.1.0.0-docLynn FosterLynn Fosterhttps://lab.allmende.io/valueflows/valueflows/-/issues/712Possible super-class for an eventual `vf:Recipe` class2024-01-06T17:37:53ZRobin VobrubaPossible super-class for an eventual `vf:Recipe` class<http://purl.org/dc/terms/MethodOfInstruction>
for example:
```turtle
vf:Recipe a owl:Class ;
rdfs:label "Recipe"@en ;
rdfs:subClassOf dcterms:MethodOfInstruction ;
vs:term_status "test...<http://purl.org/dc/terms/MethodOfInstruction>
for example:
```turtle
vf:Recipe a owl:Class ;
rdfs:label "Recipe"@en ;
rdfs:subClassOf dcterms:MethodOfInstruction ;
vs:term_status "testing" ;
rdfs:comment "..."@en ;
.
```
NOTE: I do not want to suggest VF needs a `vf:Recipe` class,
I just wanted to document that, because I came around to it, poking around.https://lab.allmende.io/valueflows/forum-valueflo-ws/-/issues/153Administrative notice about availability of GitLab CI and GitLab Pages2023-12-12T01:40:44Zjon ryala@allmende.ioAdministrative notice about availability of GitLab CI and GitLab PagesRecent developments around @compost and [degrowth/hub.degrowth.net](https://lab.allmende.io/degrowth/hub.degrowth.net) have brought about reinstation of a secure GitLab CI runner and an improved GitLab Pages setup.
- Administrators can ...Recent developments around @compost and [degrowth/hub.degrowth.net](https://lab.allmende.io/degrowth/hub.degrowth.net) have brought about reinstation of a secure GitLab CI runner and an improved GitLab Pages setup.
- Administrators can review runner configuration at [/admin/runners](https://lab.allmende.io/admin/runners)
- While pages can be activated for all projects, currently only the [valueflows/valueflows project has its runner restored](https://lab.allmende.io/valueflows/valueflows/-/settings/ci_cd)
This is not an attempt to slow down a procedure of moving to Codeberg, but rather an invitation for shared accessibility and accountability. It still leaves us with the known Identity situation about lab.allmende.io and public registration.
A better understanding of the levels of virtualisation involved in reproducing the environments that left us in summer 2021 makes this a little more reliable now.
If it becomes useful to consider that a runner could be used for tests, regular jobs or intermediary Pages builds here and there, please let me know and meanwhile suit yourself in the /admin/runners settings.https://lab.allmende.io/valueflows/valueflows/-/issues/708Create build instructions2023-10-04T15:56:03ZLynn FosterCreate build instructionsInclude a way to build for offline consumption, and to contribute / test contributions. Suggestion is to create a build.md file with this info. Also to consider automating the pylode build.
From the VF Welcome:
```
nolash
I simply ...Include a way to build for offline consumption, and to contribute / test contributions. Suggestion is to create a build.md file with this info. Also to consider automating the pylode build.
From the VF Welcome:
```
nolash
I simply ran the npm run build and it failed. so:
i thought id report it
i would like to know whether that is the right way to build the documentation for offline consumption
I realize there are html files pre-built, but in the event i would like to contribute something it would be practical to know 2.
lynnfoster
Yeah, I don't think you can build it with npm, although I am no expert on npm. :) But thank you for thinking to report it!
The build process we use is specific to mkdocs, https://www.mkdocs.org/user-guide/writing-your-docs/. That's sort of involved, you would have to install some things locally to build and test - steps 1-8 here https://lab.allmende.io/valueflows/valueflows/-/wikis/Website-publishing-procedure. But I'm happy to test other people's contributions, since I'm all set up for that. Or I'm happy to make changes myself based on issues people file.
I think for offline consumption, the easiest would be to clone from https://codeberg.org/valueflows/pages. And then run the index.html in the top directory.
For actually working on the source, you'd have to clone here https://lab.allmende.io/valueflows/valueflows/-/tree/master.
If you cloned from the gitlab, you could run it offline from https://lab.allmende.io/valueflows/valueflows/-/tree/master/mkdocs/site, that should be the same as the codeberg pages.
Julian Stirling
npm is a package manager for javascript
mkdocs is python not javacript
you need to pip install mkdocs and run that
pip install mkdocs
mkdocs build
lynnfoster
Thanks! :)
nolash
Julian Stirling: thanks for clearing that up. and mkdocs is to be run in the mkdocs subdir. For first-time visitors, those details would be good to have in an BUILD.md or something. Also, I noticed that the site I looked at last mentioned mkdocs-material as the build engine. is that no longer the case either?
lynnfoster
nolash
Julian Stirling: thanks for clearing that up. and mkdocs is to be run in the mkdocs subdir. For first-time visitors, those details would be good to have in an BUILD.md or something. Also, I noticed that the site I looked at last mentioned mkdocs-material as the build engine. is that no longer the case either?
Good idea, will do.
mkdocs-material is the same as mkdocs afaik, at least that is what I have meant here.
nolash
not quite i think
lynnfoster https://pypi.org/project/mkdocs-material/
lynnfoster
nolash
not quite i think
lynnfoster https://pypi.org/project/mkdocs-material/
ah thanks, yes the theme
anyhow, yes it is still mkdocs-material
nolash
also, the pylode step in your website publish guide can be accomplished with cli too, using:
12pip install pylode
pylode release-doc-in-process/all_vf.TTL -c true -p ontpub -o mkdocs/site/specification/all_vf.html
Julian Stirling
If you are using a few python packages (mkdocs, your theme, etc) You can make a python requirements.txt file. Then people can pass that to pip to install everything they need. If you make a README.md with how to install and run then it will display on GitLab automatically underneath the files
```Lynn FosterLynn Fosterhttps://lab.allmende.io/valueflows/app-frameworks/vf-ui/-/issues/18Repository & build system reorg and cleanup2023-07-25T08:39:39ZpospiRepository & build system reorg and cleanupKinda related to #5 but there is now much more mess to clean up on this as we work through extracting UI kits from some Neighbourhoods projects into component repositories.
https://github.com/neighbour-hoods/bugs-n-features-requests/iss...Kinda related to #5 but there is now much more mess to clean up on this as we work through extracting UI kits from some Neighbourhoods projects into component repositories.
https://github.com/neighbour-hoods/bugs-n-features-requests/issues/4 is probably the best place to keep abreast of this conversation for now. Once we have some decisions, expect some of the recently added PNPM and Vite build configuration mess to be cleaned up and better managed.
At present the build system generates a bundled package for all components within the repository *and all their dependencies*, which is unnecessarily large. But it works well enough for inclusion in other projects which is the minimum-viable functionality.
For completeness, the projects containing generic components which are yet to be refactored out into this repo are:
- https://github.com/neighbour-hoods/timetracking-applet
- https://github.com/neighbour-hoods/marketplace-appletpospipospihttps://lab.allmende.io/valueflows/forum-valueflo-ws/-/issues/152Link dumps 20232023-11-27T20:53:32ZLynn FosterLink dumps 2023Put interesting links here, for people to read now, or for parking in case we want to look them up later.Put interesting links here, for people to read now, or for parking in case we want to look them up later.https://lab.allmende.io/valueflows/valueflows/-/issues/700Clarify doc around linked data pros and cons2024-02-07T14:33:21ZLynn FosterClarify doc around linked data pros and consI'm moving this to an issue, because it was an old MR that is so out of date it can't be used anyhow as-is, so it just sits. But I want to preserve the thoughts from @elf-pavlik on this one, and use that when doing a coming round of doc...I'm moving this to an issue, because it was an old MR that is so out of date it can't be used anyhow as-is, so it just sits. But I want to preserve the thoughts from @elf-pavlik on this one, and use that when doing a coming round of doc improvements. See !444 for the old proposed text.1.0.0-docLynn FosterLynn Fosterhttps://lab.allmende.io/valueflows/valueflows/-/issues/697Do a complete RDF review2023-03-14T18:25:40ZLynn FosterDo a complete RDF reviewSince @elf-pavlik is not so involved, we are missing an RDF expert. I'd like to find someone to do a complete review of the ttl file, and make sure we are using reasonably best practices. Possibly that could dovetail into the ActivityPu...Since @elf-pavlik is not so involved, we are missing an RDF expert. I'd like to find someone to do a complete review of the ttl file, and make sure we are using reasonably best practices. Possibly that could dovetail into the ActivityPub / VF integration task? If we happen to get some money, paying an RDF person might be good use for it?1.0.0https://lab.allmende.io/valueflows/valueflows/-/issues/696Is there a vocabulary for resource use rules?2023-03-13T18:28:59ZLynn FosterIs there a vocabulary for resource use rules?This has come up a couple times now, where the requirement is for software to understand what are the rules for an agent to use/borrow/etc. another agent's resource. One is a (potential?) neighborhood tool share (query in Bonfire Networ...This has come up a couple times now, where the requirement is for software to understand what are the rules for an agent to use/borrow/etc. another agent's resource. One is a (potential?) neighborhood tool share (query in Bonfire Networks channel), the other is the Sensorica lab where people leave their personal equipment and allow others to use it too (this came up a long time ago though, we should check back).https://lab.allmende.io/valueflows/vf-schemas/vf-graphql/-/issues/104Define query API for `Unit`2023-04-03T04:21:13ZpospiDefine query API for `Unit`Time to start thinking about specs for retrieving and managing `Unit` records and the [OM ontology](https://github.com/HajoRijgersberg/OM/). See https://github.com/h-REA/hREA/pull/387#issuecomment-1426941156 for more.
- [ ] Extend `Unit...Time to start thinking about specs for retrieving and managing `Unit` records and the [OM ontology](https://github.com/HajoRijgersberg/OM/). See https://github.com/h-REA/hREA/pull/387#issuecomment-1426941156 for more.
- [ ] Extend `Unit` records with an optional `sameAs` field (corresponding to http://owl.semanticweb.org/page/Owl:sameAs.html). This would allow the GraphQL API to reference not only OM units, but units from other vocabs as well.
- [ ] Add `filter` parameters to the `units()` query API so that `sameAs: [URI!]` can be used to select sub-sets of well-known units.
Other questions:
- Is `owl:sameAs` the correct relationship to be modeling, or is this more of an `rdfs:subClassOf` situation? I figure reasoning logic that makes any comparisons is going to have to recursively fetch and compare all references either way (eg. an `hour` in the coffee shop's network is `sameAs` an `hour` in the bakery's network which is `sameAs` the OM2.0 'hour' term).
- Is one relationship (`sameAs: URI`) sufficient, or would we prefer multiple (`classifiedAs: [URI!]`)?
- Should `sameAs` return a self-referential URI to its own `Unit` record if no value is assigned? Should this be queryable for custom units?Lynn FosterLynn Fosterhttps://lab.allmende.io/valueflows/valueflows/-/issues/692Address quantity of data entry in the doc2024-01-18T19:29:48ZLynn FosterAddress quantity of data entry in the docThere is occasional feedback about too much data entry work. Sometimes this is because people are not using recipes and planning. But still, I think it would be good to think about this a bit, and address it explicitly in the doc. And...There is occasional feedback about too much data entry work. Sometimes this is because people are not using recipes and planning. But still, I think it would be good to think about this a bit, and address it explicitly in the doc. And in the model, if that is possible.
One idea we haven't addressed is using generic or specific recipes to feed the observation layer data entry. Or in the case of the FabCity work, using the design itself and/or maker doc to do the same.1.0.0-dochttps://lab.allmende.io/valueflows/valueflows/-/issues/691Integration with other vocabularies2023-01-14T17:49:45ZLynn FosterIntegration with other vocabulariesThis has come up a couple times: currently with OKH (Open Know-How, where @hoijui is a key person) in the context of open source hardware; and awhile ago with ActivityPub/ActivityStreams for adding VF to AP/AS social networking federatio...This has come up a couple times: currently with OKH (Open Know-How, where @hoijui is a key person) in the context of open source hardware; and awhile ago with ActivityPub/ActivityStreams for adding VF to AP/AS social networking federation, which is not consolidated yet. It also intersects somewhat with our practice of using other vocabularies as part of what is actually needed for a VF implementation, e.g. foaf:Agent, foaf:Person, org:Organization, geo:SpatialThing.... but is not necessarily the same.
This issue is a place to work through the best practice technical and semantic ways to document integrations in the vocabulary itself. For example, there are bunch of ways to indicate degrees of same-ness, such as [owl:sameAs](https://en.wikipedia.org/wiki/SameAs). Also, using rdfs:subClassOf or rdfs:subPropertyOf. And others, need to do some research.https://lab.allmende.io/valueflows/valueflows/-/issues/690Valueflows will need reliable distributed transactions2023-03-30T16:57:09ZBob HaugenValueflows will need reliable distributed transactionsHere's an overall description of the problem:
https://write.as/economic-networks/trying-to-explain-a-problem-and-a-use-case
More to come...Here's an overall description of the problem:
https://write.as/economic-networks/trying-to-explain-a-problem-and-a-use-case
More to come...https://lab.allmende.io/valueflows/valueflows/-/issues/688Clarify the track/trace logic2023-08-27T18:51:29ZLynn FosterClarify the track/trace logic@srfsh is in the middle of implementing `trace`. We're going to use this issue to record anything that could be fixed or clarified in the doc, and just keep track until he is done. Then I'll do a MR.@srfsh is in the middle of implementing `trace`. We're going to use this issue to record anything that could be fixed or clarified in the doc, and just keep track until he is done. Then I'll do a MR.https://lab.allmende.io/valueflows/valueflows/-/issues/686Clarify Scenario in the doc2024-01-29T20:26:25ZLynn FosterClarify Scenario in the doc`Scenario` has been confusing, and it is described at different levels of scope and inclusiveness in different places in the doc. And it is one of the loosest concepts we have, a catch-all for value flows of various sorts that are not a...`Scenario` has been confusing, and it is described at different levels of scope and inclusiveness in different places in the doc. And it is one of the loosest concepts we have, a catch-all for value flows of various sorts that are not an operational plan/agreement and not a recipe. It covers many different use cases, including ones we haven't thought of yet I'm sure.
This issue is to find where Scenario is talked about, and clarify as needed.1.0.0-docLynn FosterLynn Fosterhttps://lab.allmende.io/valueflows/vf-schemas/vf-graphql/-/issues/103rename resource_effect to accounting_effect2022-08-18T23:04:40ZConnor Turlandrename resource_effect to accounting_effectBecause resource_effect sounds to general, and like it includes both accounting_effect and onhand_effect
https://lab.allmende.io/valueflows/vf-schemas/vf-graphql/-/blob/sprout/lib/schemas/action.gql#L26Because resource_effect sounds to general, and like it includes both accounting_effect and onhand_effect
https://lab.allmende.io/valueflows/vf-schemas/vf-graphql/-/blob/sprout/lib/schemas/action.gql#L26https://lab.allmende.io/valueflows/vf-schemas/vf-graphql/-/issues/102Finalise API for location-based queries2022-06-20T01:35:44ZpospiFinalise API for location-based queriesThere are a number of `withinLocation` queries defined in the document attached [here](https://lab.allmende.io/valueflows/vf-schemas/vf-graphql/-/issues/84#note_39817).
We need to implement these, and decide on an appropriate API format...There are a number of `withinLocation` queries defined in the document attached [here](https://lab.allmende.io/valueflows/vf-schemas/vf-graphql/-/issues/84#note_39817).
We need to implement these, and decide on an appropriate API format for querying them.