Living Manual

A complete overhaul and re-development of Gary Grigsby's War in the East, with a focus on improvements to historical accuracy, realism, user interface and AI.

Moderator: Joel Billings

Post Reply
User avatar
Joel Billings
Posts: 33462
Joined: Wed Sep 20, 2000 8:00 am
Location: Santa Rosa, CA
Contact:

Re: Living Manual

Post by Joel Billings »

All understanding comes after the fact.
-- Soren Kierkegaard
User avatar
chee006
Posts: 47
Joined: Wed Dec 27, 2017 6:22 am
Contact:

Re: Living Manual

Post by chee006 »

Sorry if this has been answered before, but may I know why don'=n't we just update the main manual instead of recreating multiple living manuals without the full images and color?
MarkShot
Posts: 7440
Joined: Sat Mar 29, 2003 6:04 am

Re: Living Manual

Post by MarkShot »

I think it is an efficiency issue, since some companies like PDS and CA make the players write the documentation.

The living manual is a beta task which means it uncompensated, and those who are compensated are working on code which few of the betas would be qualified to do anyway.

Yes, the betas did do the main manual, but if you were going to do this seriously, you would need to update screen captures. Also, early in most of 2by3 releases, there was a new beta build almost every 2-3 weeks; the current long delay is due to a single monolithic upgrade project (OOB 2.0).

The above is conjecture. I am not privy to any insider knowledge.
2021 - Resigned in writing as a 20+ year Matrix Beta and never looked back ...
User avatar
loki100
Posts: 11705
Joined: Sat Oct 20, 2012 12:38 pm
Location: Utlima Thule

Re: Living Manual

Post by loki100 »

The explanation is actually really simple.

We handed in about 900 pages of text (ie what is now the Living Manual) and all the images. So that would easily have generated about 1000+ pages of published manual.

The layout people managed to squeeze all that into the 520 or so pages of the published version. There was then a tussle in the days immediate prior to release to get the order of text-images improved so that it wasn't all over the place. The result was yes we inherited a 520 page word document with all the images. Add a single letter and the whole thing falls apart and needs a massive effort to reformat.

So it was just not feasible to use as the basis for the Living Manual - but it could have been if the option to generate an official HTML variant had been on offer

and yes doing the Living Manual is indeed unpaid and voluntary - and I long lost any enthusiasm for voluntary work given the actions of a small vocal sub-set of the community
User avatar
Zovs
Posts: 9166
Joined: Sun Feb 22, 2009 11:02 pm
Location: United States

Re: Living Manual

Post by Zovs »

Early on there was sometimes a release or update once a day, the norm was 2-3 days a release then once a week would be norm with daily or every other day bug releases.
Image
Beta Tester for: War in the East 1 & 2, WarPlan & WarPlan Pacific, Valor & Victory, Flashpoint Campaigns: Sudden Storm, Computer War In Europe 2
SPWW2 & SPMBT scenario creator
Tester for WDS games
MarkShot
Posts: 7440
Joined: Sat Mar 29, 2003 6:04 am

Re: Living Manual

Post by MarkShot »

I was around for the early days of commercial software; before the Internet.

We received monthly:

* Patch tapes (real patches; they replaced instructions in disk files with a hex editor); along with detailed notes on each one.

* Sheets of 3 ring binder pages with replacement instructions for various sets of pages.

We have come from this to "read the WIKI" or "search the forum".

---

Loki, I very much appreciate your fine work. WITE2 was my first GG title, and being on Panther's team so many years I was an anti-TBS/HEX snob. It was actually reading your very professional manual for WITE2 which led me down the road of purchasing most of GG's titles.

I owe you very much for having a richer retirement. Thank you, Loki. (and all the 2by3 developers and betas)
2021 - Resigned in writing as a 20+ year Matrix Beta and never looked back ...
User avatar
chee006
Posts: 47
Joined: Wed Dec 27, 2017 6:22 am
Contact:

Re: Living Manual

Post by chee006 »

loki100 wrote: Mon Jul 24, 2023 8:48 am The explanation is actually really simple.

We handed in about 900 pages of text (ie what is now the Living Manual) and all the images. So that would easily have generated about 1000+ pages of published manual.

The layout people managed to squeeze all that into the 520 or so pages of the published version. There was then a tussle in the days immediate prior to release to get the order of text-images improved so that it wasn't all over the place. The result was yes we inherited a 520 page word document with all the images. Add a single letter and the whole thing falls apart and needs a massive effort to reformat.

So it was just not feasible to use as the basis for the Living Manual - but it could have been if the option to generate an official HTML variant had been on offer

and yes doing the Living Manual is indeed unpaid and voluntary - and I long lost any enthusiasm for voluntary work given the actions of a small vocal sub-set of the community
Thanks for the clarification, I was not aware that it was voluntary work but I am grateful for all the work the community has put in. I am not sure what you mean by vocal sub-set of the community as I am fairly new to this part of the forums.
User avatar
Joel Billings
Posts: 33462
Joined: Wed Sep 20, 2000 8:00 am
Location: Santa Rosa, CA
Contact:

Re: Living Manual

Post by Joel Billings »

Denniss wrote: Sat Apr 29, 2023 8:28 pm https://www.matrixgames.com/forums/view ... 1&t=395027
should be worth including

These are really good screens. I've stickied the thread in the war room. Adding them into the manual is a bridge too far for me.
All understanding comes after the fact.
-- Soren Kierkegaard
User avatar
Joel Billings
Posts: 33462
Joined: Wed Sep 20, 2000 8:00 am
Location: Santa Rosa, CA
Contact:

Re: Living Manual

Post by Joel Billings »

I think I've picked up the items posted here over the past few months for the next living manual. I confirmed that it is 60% of damaged element manpower goes to the disabled pool, not 40%, and it appears it's was intentional, and has been like this since release. It is different than WitW. I forgot to ask Gary about the manpower item, but it sounds like something he would do, and the posted screenshots clearly shows it's impacting things. Thanks for pointing out these corrections to be made.
All understanding comes after the fact.
-- Soren Kierkegaard
Arthurius
Posts: 57
Joined: Tue May 07, 2019 10:01 am

Re: Living Manual

Post by Arthurius »

What is exatly imapct of ,,Logistics Level'' Option. There aren't any description in manual. Is this affect on:

a) supply consumption
b) supply range
c) supply prodution
d) suppply loses
e) none of above
f) any else
User avatar
Joel Billings
Posts: 33462
Joined: Wed Sep 20, 2000 8:00 am
Location: Santa Rosa, CA
Contact:

Re: Living Manual

Post by Joel Billings »

I'm not sure, will have to ask Gary if he can find in the code what it impacts.
All understanding comes after the fact.
-- Soren Kierkegaard
User avatar
Joel Billings
Posts: 33462
Joined: Wed Sep 20, 2000 8:00 am
Location: Santa Rosa, CA
Contact:

Re: Living Manual

Post by Joel Billings »

It appears the fact that the show event screen only lists the latest item is not mentioned in the manual. A mention could be added to 36.15. There is a thread here: https://www.matrixgames.com/forums/view ... 5#p5118485 .
All understanding comes after the fact.
-- Soren Kierkegaard
User avatar
Joel Billings
Posts: 33462
Joined: Wed Sep 20, 2000 8:00 am
Location: Santa Rosa, CA
Contact:

Re: Living Manual

Post by Joel Billings »

Arthurius wrote: Sat Aug 12, 2023 10:32 am What is exatly imapct of ,,Logistics Level'' Option. There aren't any description in manual. Is this affect on:

a) supply consumption
b) supply range
c) supply prodution
d) suppply loses
e) none of above
f) any else

The manual says this in 36.18:

Logistics Level: Impacts the formulas that determine the amount of supply and replacements a unit receives based on its supply trace, to include through ports, the amount of attrition a unit suffers due to movement, the amount of fatigue added or removed from a unit during a turn, and the amount of fuel expended by generic vehicles. This level also affects the ability of leaders to conduct successful admin checks.
All understanding comes after the fact.
-- Soren Kierkegaard
User avatar
Wiedrock
Posts: 1440
Joined: Tue Oct 11, 2022 7:44 pm
Location: Germany

Re: Living Manual

Post by Wiedrock »

Living Manual 1.23 wrote:28.6.2. Factory Damage
In addition to capture damage, all factories can be damaged by the strategic
bombing (bomb city) air mission (18.1.5).
Damage is applied to an entire factory, not to individual factory points. The damage
level of a factory is also the probability that the factory will not produce on a given
turn.
For example 100 damage means no production, while 25 damage means 25 percent
chance of no production and a 75 percent chance of full production. For example a
FW-190 aircraft factory with 12 factory points, or size 12, which had 40 damage
would have a 60 percent chance of producing 12 aircraft and a 40 percent chance of
producing 0 aircraft.
see attachment.

Seems not to be the case to work like that but exactly using percentages and rounding up.
Attachments
manual_factory-damage.png
manual_factory-damage.png (689.21 KiB) Viewed 1884 times
Lurberri
Posts: 98
Joined: Thu May 13, 2021 8:04 am

Re: Living Manual

Post by Lurberri »

Wiedrock wrote: Tue Nov 07, 2023 7:33 pm
Living Manual 1.23 wrote:28.6.2. Factory Damage
In addition to capture damage, all factories can be damaged by the strategic
bombing (bomb city) air mission (18.1.5).
Damage is applied to an entire factory, not to individual factory points. The damage
level of a factory is also the probability that the factory will not produce on a given
turn.
For example 100 damage means no production, while 25 damage means 25 percent
chance of no production and a 75 percent chance of full production. For example a
FW-190 aircraft factory with 12 factory points, or size 12, which had 40 damage
would have a 60 percent chance of producing 12 aircraft and a 40 percent chance of
producing 0 aircraft.
see attachment.

Seems not to be the case to work like that but exactly using percentages and rounding up.
It seems more correct to me as it is currently implemented in the game, although it is obvious that the manual needs to be corrected.
User avatar
Wiedrock
Posts: 1440
Joined: Tue Oct 11, 2022 7:44 pm
Location: Germany

Re: Living Manual

Post by Wiedrock »

The values for additional MP requirement depending on Ground weather/Roads/Motorization in the manual need an update.
Attachments
MP-weather-roads.png
MP-weather-roads.png (178.62 KiB) Viewed 1794 times
User avatar
Wiedrock
Posts: 1440
Joined: Tue Oct 11, 2022 7:44 pm
Location: Germany

Re: Living Manual

Post by Wiedrock »

This Chart is missing 2x "." (decimal points).
Attachments
mp-debuff.png
mp-debuff.png (28.24 KiB) Viewed 1668 times
warhero88AB
Posts: 10
Joined: Mon Nov 27, 2023 10:52 pm

Re: Living Manual

Post by warhero88AB »

New to this game, not new to monster wargames (War in Europe, etc). Currently wading through this games very, very nice but voluminous manual. Am I to understand that I also need to read 1 to N "living manuals" in order to be fully up to date on rules? I mean, how significant are the adds and fixes?
User avatar
Wiedrock
Posts: 1440
Joined: Tue Oct 11, 2022 7:44 pm
Location: Germany

Re: Living Manual

Post by Wiedrock »

warhero88AB wrote: Fri Dec 01, 2023 4:00 am New to this game, not new to monster wargames (War in Europe, etc). Currently wading through this games very, very nice but voluminous manual. Am I to understand that I also need to read 1 to N "living manuals" in order to be fully up to date on rules? I mean, how significant are the adds and fixes?
You can mostly stick to the normal manual. Before reading a Chapter, take a quick look in the latest version of that chapter in the living manual (current version is 1.23). There look out for red text and Erratas.
User avatar
Joel Billings
Posts: 33462
Joined: Wed Sep 20, 2000 8:00 am
Location: Santa Rosa, CA
Contact:

Re: Living Manual

Post by Joel Billings »

An item for the living manual is here: https://www.matrixgames.com/forums/view ... 7&t=400330
All understanding comes after the fact.
-- Soren Kierkegaard
Post Reply

Return to “Gary Grigsby's War in the East 2”