Add information about build and test zanshin into HACKING file
AbandonedPublic

Authored by ervin on Jan 20 2017, 4:27 PM.

Details

Reviewers
booleon
Summary

Trying to improve the documentation it's the first step needed for someone stepping into the project.

Diff Detail

Repository
R4 Zanshin
Lint
Lint Skipped
Unit
Unit Tests Skipped
booleon updated this revision to Diff 10392.Jan 20 2017, 4:27 PM
booleon retitled this revision from to Add information about build and test zanshin into HACKING file.
booleon updated this object.
booleon edited the test plan for this revision. (Show Details)
booleon added a reviewer: ervin.
booleon set the repository for this revision to R4 Zanshin.
booleon added a project: Zanshin.
booleon added a subscriber: Zanshin.
ervin requested changes to this revision.Jan 21 2017, 4:46 PM
ervin edited edge metadata.

Thanks for looking at completing this. Indeed that's needed. Improvements still required on grammar and on how generic those advises are.

HACKING
66

First install the dependencies

67–79

Too distro specific, could that be done in a more generic manner?

Beside on Arch you cover cucumber but not on Mint that looks suspicious.

82–85

I'd expect the mkdir and cd, etc. Really the commands to get the thing built from the source directory.

91

"zanshin", lower case here.

93

"tests" (missing plural).

94

Unit Tests

96

Note it runs the acceptance tests too.

97

Acceptance Tests

98–99

running ctest from $BUILDDIR/tests/features would be a better advice

This revision now requires changes to proceed.Jan 21 2017, 4:46 PM
booleon updated this revision to Diff 12296.Mar 8 2017, 3:42 PM
booleon edited edge metadata.

Correction to the first patch on HACKING D4225
I clicked on update patch.

PS : If I did it wrong please tell me :-)

ervin requested changes to this revision.Mar 8 2017, 8:11 PM

Now we're talking! I can properly review now.

Almost there, still a few adjustments needed IMO.

HACKING
10–11

I wouldn't separate in two lists like that, since it's build instruction you need to install all the necessary to build and run anyway. Besides I think you got some of it wrong between depends and makedepends. So, simplify an make a single dependency list here.

25

"tests" (plural missing)

32

"zanshin" with a lower case Z here too.

This revision now requires changes to proceed.Mar 8 2017, 8:11 PM
ervin commandeered this revision.Aug 16 2017, 8:10 AM
ervin abandoned this revision.
ervin edited reviewers, added: booleon; removed: ervin.

Doesn't look like my comments are going to be addressed, closing it for now.