-
Notifications
You must be signed in to change notification settings - Fork 20
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
The structure of a digital research object #113
Comments
@Repositorian raises a couple of issues which are not in the core objective of everpub as I see it, but which we need to take into account in some way, if only by deciding to look at them later. BTW, I have explored some of this issues in my ActivePapers project and discussed them in this paper. I see the core objective of everpub as providing technology, i.e. software tools, for the creation of computational documents that allow interactive manipulation. Obviously these documents will have some internal structure. From an implementation point of view, each document consists of a computational environment, software libraries, notebooks, and documentation. However, this implementation-oriented structure is not necessarily reasonable from different points of view, such as referring to specific pieces from other research objects. Today it is common in a paper to refer to "Equation 5 of reference 15". In computational papers, such references should still be possible, and even be more versatile. I might want to refer to a dataset, a cell in a notebook, or a line in a code module, either for (computational) reuse or simply for discussing the science in some detail. These preoccupations are largely orthogonal to the technical core objectives, so we can just brush them aside for now. The main risk is that everpub becomes an instant success and computational documents will not be citable for the next 10 years because we didn't think about it. If you consider this unlikely, read a bit about this history of JavaScript. At some point we will have to think about the "publishing object model" that @Repositorian refers to. Of course others are working on this as well, and it would be good to keep an eye of what is happening. Or we decide that this is somebody else's problem, and encourage people to play with different object models inside the everpub platform. |
Hadn't thought about this before and the question of how you refer to On Sat, Mar 5, 2016 at 7:30 PM Konrad Hinsen [email protected]
|
"It depends" and "time will tell". We can't rely on much experience with this. The difficult references are those for use by a computer program. Humans adapt to anything that's reasonably clear. In ActivePapers, I use references at the HDF5 dataset level. This has proven sufficient but until now all ActivePapers I know of are supplements to traditional papers, containing no narrative of their own. |
A discussion started on another issue by @Repositorian, which deserves its own issue.
The text was updated successfully, but these errors were encountered: