Figured I'd post an update as well.
My life is now back on track and on a schedule since school has started, and I've been able to commit more frequently and plan on keeping this up now. Currently working my way through the mwworld folder, though of course I haven't gotten as far as I would have liked...
Documentation
Re: Documentation
'MURICA!Ravenwing wrote:Have we decided to use American or British English?
Just kidding. I should probably stop wrecking our release announcements with American English.
- psi29a
- Posts: 5362
- Joined: 29 Sep 2011, 10:13
- Location: Belgium
- Gitlab profile: https://gitlab.com/psi29a/
- Contact:
Re: Documentation
Pick a style and go with it.
Update: It has to be readable/understandable to the majority of English speakers.
Update 2: If people want to write their own documentation in another language, I'll try to figure out multi-language support.
Update: It has to be readable/understandable to the majority of English speakers.
Update 2: If people want to write their own documentation in another language, I'll try to figure out multi-language support.
Re: Documentation
*Laughs maniacally*psi29a wrote:Pick a style and go with it.
Kill joy. But seriously, yes, I was planning on being conversationally simple so it's easy to understand and translate, but not antiseptic. And I'll probably go through a few different styles before I settle on one and write up a brief style guide. I'm guessing no one will feel like I'm stepping on toes if I go back through and edit some of the earlier stuff to match character and tone?psi29a wrote:Update: It has to be readable/understandable to the majority of English speakers.
Ugh, I just vomited a little. Lol, I was actually considering British English because I know many developers and fans are European. I assumed everyone in Europe learned British English, but if you learned American English, DavidD, then maybe we have more American English users. I know we have a lot of Germans. What do they usually teach in Germany? I'm sure this is making a much larger deal out of it than it needs to be, but I love uniformity and consistency. Would a poll perhaps be helpful?raevol wrote:'MURICA!
Thanks! I will probably have many, sooooo...DavidD wrote: Mostly just Git related things. Knowing how to fork a repository, committing, pushing, merging, and pull requests will get you far. Since the documentation is mostly unwritten, you have pretty free hands. The source documentation is located inside the docs/source folder. The "openmw" folder is currently used for the source code, and the "openmw-cs" is for the cs manual.
If you need any help or have any questions, feel free to ask here!
What are you considering writing about?
I was planning on starting with the User Documentation from the Wiki so all I have to focus on is syntax. Once I get that down I think I'll move on to OpenMW-CS. If there's any kind of grunt work type stuff for the source documentation, I'm willing to help with that as long as it doesn't require a deep understanding of the code. I have an extremely basic understanding of C++, so I'm not entirely useless, but I don't want to misunderstand and mislead people.
Re: Documentation
I honestly did too, but there's sacrifices you have to make in the name of comedy.Ravenwing wrote:Ugh, I just vomited a little. Lol, I was actually considering British English because I know many developers and fans are European.
I don't think we need a poll, people should just do what they are comfortable with, favoring British English if they can. We shouldn't discourage contributions just because of opinions on spelling.
- AnyOldName3
- Posts: 2684
- Joined: 26 Nov 2015, 03:25
Re: Documentation
The superiority of British spellings is not an opinion. It is a fact.raevol wrote:I honestly did too, but there's sacrifices you have to make in the name of comedy.Ravenwing wrote:Ugh, I just vomited a little. Lol, I was actually considering British English because I know many developers and fans are European.
I don't think we need a poll, people should just do what they are comfortable with, favoring British English if they can. We shouldn't discourage contributions just because of opinions on spelling.
Re: Documentation
Swedes learn english as British English in school, then relearn English as American English from movies and internet. That's it kind of. The Brits need to start making more movies if they want us to speak like them.
Re: Documentation
I've been looking at CellStore for a while now, but I don't understand why mMovedHere and mMovedToAnotherCell are needed. Could someone with more knowledge about this explain why they are needed? Why not just add them directly into e.g. mArmors and make the item owned by the cell that the object is moved to?
MWWorld should be mostly implemented at this point, right? So I should be able to rely on major pieces of code remaining for the final release unless nothing else is stated? In that case I can start writing more in-depth instead of just scraping the surface
MWWorld should be mostly implemented at this point, right? So I should be able to rely on major pieces of code remaining for the final release unless nothing else is stated? In that case I can start writing more in-depth instead of just scraping the surface
Re: Documentation
Because that is not how Morrowind works. Instances are kept in their original cells. We can't change that without breaking a whole lot of stuff (mods, the esp/esm format and so on).
Re: Documentation
Fair enough . Curious design decision from BethesdaZini wrote:Because that is not how Morrowind works. Instances are kept in their original cells. We can't change that without breaking a whole lot of stuff (mods, the esp/esm format and so on).