Thanks Marshall! That answered my question.
Peter
On 26.11.2012 15:48, Marshall Schor wrote:
On 11/20/2012 10:46 AM, Peter Klügl wrote:
... <snip>
Hmm, let me illustrate my question a bit more. I want to provide some
exemplary TextMarker projects, which are Eclipse projects with a TextMarker
nature, containing some script files with rules and textual documents the
rules are written for, etc... The project is supposed to be built with the
TextMarker IDE, so no maven, no pom, only some sort of TextMarker builder. So
its rather something like the former corpus project for the CAS Editor.
I usually store my TextMarker projects for information extraction applications
in my own SVN and have the advantages, e.g., of versioning of the rule files.
My natural attempt would be to commit the example project to our SVN, so that
new TextMarker user can check out the project in the TextMarker IDE and play a
bit around with the provided rules/files. However, I can imagine that the
approriate location of those projects is not the sandbox SVN. Maybe its better
provided as an archive at my personal webspace at people.apache.org.
Is it OK, if I create a new folder like
uima/sandbox/trunk/TextMarker/example-projects? If yes, then how strict do I
have to be about adding license information to the textual files?
Yes, I think this is fine. It's a subfolder of TextMarker, so it won't be
confused with other things.
I'm not sure about the other question. There are two parts here. One is, we
don't want files in our SVN that are under some non-conforming license, such as
the GPL. But I would guess that you are instead talking about sample files of
text that you use in TextMarker, which you "made up", but don't want to pollute
with the normal Apache header because it would mess up the TextMarker
processing. For these kinds of files you can document (perhaps in a separate
file in some containing folder) what the situation is with those files. In
uimaj-examples, these files are documented in the POM, which builds/packages the
examples and all of the demo projects within it, in the part of the POM that
specifies RAT exclusions (RAT is the automated build checker that examines all
the files to see that they have the proper license headers).
I hope this answers your question, but if I've misunderstood something, please
ask again.
-Marshall
Best,
Peter
PS: I usually also store the build result of a TextMarker project, that is the
set of descriptors, also in the SVN, but I can change that :-)
-Marshall
If you have a lot
On 11/20/2012 9:20 AM, Peter Klügl wrote:
Hi,
I have two simple questions about writing documentation:
1. Are there any best practices of formatting the docbook documentation. The
XML-formatting in Eclipse is quite annoying. Do you use an external editor?
2. Is it OK to put example projects in the same place in the SVN as the java
implementation. The example projects for TextMarker are of course TextMarker
projects, which are not built with maven. Is a new folder in the TextMarker
folder appropriate?
Best,
Peter
