About Monkey 2 › Forums › Monkey 2 Development › Integrated docs gitHub community organisation
This topic contains 41 replies, has 11 voices, and was last updated by
abakobo
3 months, 2 weeks ago.
-
AuthorPosts
-
November 8, 2017 at 10:01 pm #11575
For those who want a white themed docs:
http://turdus.be/monkey2docs/whitedocs/The official docs are now white themed.
November 11, 2017 at 4:48 pm #11634Added a link in the online docs to the white doc page…
December 19, 2017 at 11:34 am #12375Very useful. Thanks!
March 8, 2018 at 11:09 am #13911Could anybody check the english (and mx2) correctness of the following modification in docs before requesting a pull?
thx
https://github.com/blitz-research/monkey2/compare/develop...abakobo:wipdocs
March 8, 2018 at 5:49 pm #13918Hey Abakobo, I read over the commit and made a few small changes. You can see them here
Sorry about the weird line break changes, I’m not sure what caused that.
Also, I had a question about this line in modules/monkey/language/newdocs/pointers.md:
Note that casting to Void Ptr is essentially used when dealing with external native code.
I don’t understand Void Ptr enough to understand this line, but using “essentially” in that way doesn’t seem right. Do you mean it is the only use for Void Ptr, or just a common use?
If it’s a common use, but not the only use, you might say:
Note that casting to Void Ptr is commonly used when dealing with external native code.
If dealing with external code is the only use for Void Ptr, you might want to be more specific:
Casting to Void Ptr is used when dealing with external code.
In the latter case, it might make more sense to move that up the doc towards a bit more, as it seems like an important piece of information to leave down at the end in a note.
March 8, 2018 at 11:43 pm #13928thanks arawkins!
April 5, 2018 at 8:11 am #14252@abakobo Hello! Just found this thread. I can’t believe I’d missed/forgotten about it!
I’m wondering how the docs get from the m2docsCommunity repo onto the turdus.be website? I presume that requires some sort of manual operation by you to upload it?
BTW are you one of the turdus band members?
April 5, 2018 at 10:20 am #14256According to the github page, on the wipdocs branch :
This branch is 27 commits ahead, 7 commits behind blitz-research:develop.
Those 27 commits are the ‘dev up’ merges and shouldn’t really show up here. I don’t understand why github doesn’t understand that they have been remerged back into blitz-research:develop.
Anyway, I have rebased the wipdocs branch onto the latest blitz-research:develop (on my machine), and published the result to a new branch on m2docsCommunity repo called ‘rebased’. It currently says :
This branch is even with blitz-research:develop
I think that if we now use this ‘rebased’ branch for pushing all doc updates, I will then be able to rebase it again before sending Mark a pull request. As I’ve said before though rebasing is dangerous as it rewrites history and we should only do it once in a while, probably just before mark releases each new version. One other advantage of us rebasing before Mark pulls is that if there are any conflicts, we can fix them before sending the pull request instead of dumping them on Mark!
April 10, 2018 at 10:02 am #14310ok nice!
sorry was a bit off mx2 last days…
But great! Welcome to the docs community!Do you plan to write specific things (so we don’t work on the same ones..)?
April 10, 2018 at 10:18 am #14313Like you, I will have flurries of activity punctuated by periods of absence, depending on how my day job is going – I’m self-employed so my timetable tends to be erratic. It would seem sensible to assign yourself an issue on github if you start writing on a particular topic. That way we have a record of who is doing what. I will probably try to tackle the issues I have reported on github before anything else. And perhaps class functions. But I leave for an 8 day holiday tomorrow so won’t be doing anything for a little while!
January 2, 2019 at 2:38 am #15829This seems to be outdated.
It is not synchronized to Monkey2:
This branch is 28 commits ahead, 72 commits behind blitz-research:develop.Would it be a problem to make pull requests directly to blitz-research/monkey2?
January 2, 2019 at 10:19 am #15833The mx2community fork is more an issue container than a base repo for pull requests. I personally directly use my mx2 fork for pull requests.
I could sync the fork though.
If you want admin privileges on the fork you can give your githhub nickname… -
AuthorPosts
You must be logged in to reply to this topic.