Some thoughts
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 15/100
- Issue type
- Feature
- Clarity
- Needs clarification
- Activity status
- Stale
- Tech stack
- cmake, cpp, github-actions
- Domain
- build-system, cli, documentation, testing
Research direction
Start by reviewing the repository's CMakeLists, current documentation exports, and existing CLI test setup. The issue bundles several independent requests—documentation targets, a CMake-based test system, and SeqAn3 update automation—so each needs a defined scope and completion check before implementation.
Written by the indexing model from the issue text.
Description
First of all: it's great to have this!
I just looked through this repository and had the following very subjective thoughts. Please see this as constructive criticism :)
There are many things I found surprising to see / have never seen with applications before. This includes most of the test things, but also Doxygen. While the terms might be clear for a library developer, in the context of the APP, they are not clear to me. Does an app have an API? And if yes, isn't this the CLI? Why are tests for the CLI written inside C++? I don't think I have ever seen that before, and I am fairly sure regular app developers have never heard of GMock etc.
Similarly: what does the documentation cover? The interface of the binary or some functions inside the app source code? Why would users of the app be interested in the latter?
Don't get me wrong, I do think that these things might make sense for large applications that have multiple developers and are maintained for a longer period of time. And I also think that it is kind of fancy that one can write app-tests from inside C++ and have coverage checked... I just don't see 90% of this happening in most academic projects or even projects in my company. So for the assumed primary audience, it feels a little over-engineered -> there are a lot of things to understand that are likely not relevant, while those things that are, are not easy to do.
Being an app-developer myself, I am primarily interested in the following:
- Repository that has SeqAn3 included as submodule and provides a CMakeLists
- Help with setting up Github CI
- Predefined make targets to export the command-line description. This is the documentation for the APP. In the context of Github, an export to GFMD would be great, but the exports to man and html that we currently have are also good!
make doc-html,make doc-md... - An easy test-system where I only need to provide three things per test (CLI arguments, input data, output control data). Ideally, this would be a CMake-macro that takes exactly these three arguments and understands if the URL to the data is a local folder or a http-link with a tarball in which cases it fetches the stuff.
- Nice-to-have:
make update-seqan3updates the SeqAn3 submodule to the latest stable release and prints the release notes :)
- Dominant language
- CMake
- Stars
- 6
- Forks
- 9
- Avg merge
- 23h 34m
- Merged PRs (30d)
- 3
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from seqan/app-template
-
Add CMake Presets Open
seqan/app-template#139 · 1 assignee ·
-
Difficulty 3/5 1-2 days Newbie friendliness 45/100
seqan/app-template#65 ·
-
Make a release. Open
Difficulty 5/5 Over a week Newbie friendliness 20/100
seqan/app-template#62 ·
-
Difficulty 4/5 3-5 days Newbie friendliness 35/100
seqan/app-template#61 ·
-
Difficulty 3/5 1-2 days Newbie friendliness 38/100
seqan/app-template#60 ·
All issues in seqan/app-template
Similar issues
-
Needs Design Priority: Wishlist
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
elementary/flatpak-platform#253 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
objectionary/hone-maven-plugin#1060 ·
-
0.kind: build failure
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
-
Update Vish to 1.1.5 Openpackage-update
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
oSoWoSo/vOid_Community_repOsitory#144 · 1 comment ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100