Discuss the "windows" property in DITA

[yamasite]

The "windows" property is currently in a state of chaos.

The RTC C++ SDK is meant to support all platforms, technically. However, the "windows" property is currently used to represent the C++ SDK, which creates loads of confusion. In addition, RTC plans to add C#, which is a Windows-only SDK. It's better to make prop names concise and accurate.

[yamasite]

Need to clarify the props:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "subjectScheme.dtd">
<subjectScheme>
    <title>Conditions for RTC/RTC NG</title>
    <subjectdef keys="filters">
        <topicmeta>
            <navtitle>Filters</navtitle>
        </topicmeta>
        <subjectdef keys="native">
            <topicmeta>
                <navtitle>All native platforms</navtitle>
            </topicmeta>
            <subjectdef keys="android">
                <topicmeta>
                    <navtitle>Android</navtitle>
                </topicmeta>
            </subjectdef>
            <subjectdef keys="apple">
                <topicmeta>
                    <navtitle>iOS and macOS</navtitle>
                </topicmeta>
                <subjectdef keys="ios">
                    <topicmeta>
                        <navtitle>iOS</navtitle>
                    </topicmeta>
                </subjectdef>
                <subjectdef keys="mac">
                    <topicmeta>
                        <navtitle>macOS</navtitle>
                    </topicmeta>
                </subjectdef>
            </subjectdef>
            <subjectdef keys="windows">
                <topicmeta>
                    <navtitle>Windows</navtitle>
                </topicmeta>
            </subjectdef>
        </subjectdef>
        <subjectdef keys="web">
            <topicmeta>
                <navtitle>Web</navtitle>
            </topicmeta>
        </subjectdef>
        <subjectdef keys="framework">
            <topicmeta>
                <navtitle>All framework platforms</navtitle>
            </topicmeta>
            <subjectdef keys="rn">
                <topicmeta>
                    <navtitle>React Native</navtitle>
                </topicmeta>
            </subjectdef>
            <subjectdef keys="unity">
                <topicmeta>
                    <navtitle>Unity</navtitle>
                </topicmeta>
            </subjectdef>
            <subjectdef keys="electron">
                <topicmeta>
                    <navtitle>Electron</navtitle>
                </topicmeta>
            </subjectdef>
            <subjectdef keys="cocos-creator">
                <topicmeta>
                    <navtitle>Cocos Creator</navtitle>
                </topicmeta>
            </subjectdef>
            <subjectdef keys="cocos2d-x-android">
                <topicmeta>
                    <navtitle>Cocos2d-x Android</navtitle>
                </topicmeta>
            </subjectdef>
            <subjectdef keys="cocos2d-x-ios">
                <topicmeta>
                    <navtitle>Cocos2d-x iOS</navtitle>
                </topicmeta>
            </subjectdef>
            <subjectdef keys="rust">
                <topicmeta>
                    <navtitle>Rust</navtitle>
                </topicmeta>
            </subjectdef>
            <subjectdef keys="flutter">
                <topicmeta>
                    <navtitle>Flutter</navtitle>
                </topicmeta>
            </subjectdef>
        </subjectdef>
        <subjectdef keys="rtc-ng">
            <topicmeta>
                <navtitle>RTC NG products</navtitle>
            </topicmeta>
        </subjectdef>
        <subjectdef keys="rtc">
            <topicmeta>
                <navtitle>RTC products</navtitle>
            </topicmeta>
        </subjectdef>
        <subjectdef keys="audio">
            <topicmeta>
                <navtitle>Voice Call</navtitle>
            </topicmeta>
        </subjectdef>
        <subjectdef keys="video">
            <topicmeta>
                <navtitle>Video Call</navtitle>
            </topicmeta>
        </subjectdef>
        <subjectdef keys="live">
            <topicmeta>
                <navtitle>Interactive Live Streaming Premium</navtitle>
            </topicmeta>
        </subjectdef>
        <subjectdef keys="lives">
            <topicmeta>
                <navtitle>Interactive Live Streaming Standard</navtitle>
            </topicmeta>
        </subjectdef>
        <subjectdef keys="cn">
            <topicmeta>
                <navtitle>Chinese only</navtitle>
            </topicmeta>
        </subjectdef>
        <subjectdef keys="hide">
            <topicmeta>
                <navtitle>Not public for now</navtitle>
            </topicmeta>
        </subjectdef>
    </subjectdef>
    <!--Bind all condition values to the props attribute-->
    <enumerationdef>
        <attributedef name="props"/>
        <subjectdef keyref="filters"/>
    </enumerationdef>
    <!--Hide all useless profiling attributes-->
    <enumerationdef>
        <attributedef name="platform"/>
        <subjectdef/>
    </enumerationdef>
    <enumerationdef>
        <attributedef name="product"/>
        <subjectdef/>
    </enumerationdef>
    <enumerationdef>
        <attributedef name="rev"/>
        <subjectdef/>
    </enumerationdef>
</subjectScheme>

[Cilla-luodan]

1. Add subjectdef keys="cpp" to replace the current "windows";
2. Replace props="windows" with props="cpp" in all related files;
3. Use subjectdef keys="windows" or "c" for windows (C#);
4. Cancel hierarchy relations in subject-scheme-rtc.ditamap;

• Example of filter-windows-rtc-ng.ditaval:

    <!-- Only include Windows(C#) -->
    <prop action="exclude" att="props" val="android"/>
    <prop action="exclude" att="props" val="ios"/>
    <prop action="exclude" att="props" val="mac"/>
    <prop action="exclude" att="props" val="web"/>
    <prop action="include" att="props" val="windows"/>
    <prop action="exclude" att="props" val="cpp"/>
    <!-- Exclude all frameworks -->
    <prop action="include" att="props" val="native"/>
    <prop action="exclude" att="props" val="cocos-creator"/>
    <prop action="exclude" att="props" val="cocos2d-x-android"/>
    <prop action="exclude" att="props" val="cocos2d-x-ios"/>
    <prop action="exclude" att="props" val="electron"/>
    <prop action="exclude" att="props" val="flutter"/>
    <prop action="exclude" att="props" val="rn"/>
    <prop action="exclude" att="props" val="rust"/>
    <prop action="exclude" att="props" val="unity"/>
    <!-- Only inlcude NG -->
    <prop action="exclude" att="props" val="rtc"/>
    <prop action="include" att="props" val="rtc-ng"/>
    <prop action="exclude" att="props" val="hide"/>

• Example of filter-cpp-rtc-ng.ditaval:

    <!-- Include cpp -->
    <prop action="exclude" att="props" val="android"/>
    <prop action="exclude" att="props" val="ios"/>
    <prop action="exclude" att="props" val="mac"/>
    <prop action="exclude" att="props" val="web"/>
    <prop action="include" att="props" val="cpp"/>
    <!-- Exclude all frameworks -->
    <prop action="include" att="props" val="native"/>
    <prop action="exclude" att="props" val="cocos-creator"/>
    <prop action="exclude" att="props" val="cocos2d-x-android"/>
    <prop action="exclude" att="props" val="cocos2d-x-ios"/>
    <prop action="exclude" att="props" val="electron"/>
    <prop action="exclude" att="props" val="flutter"/>
    <prop action="exclude" att="props" val="rn"/>
    <prop action="exclude" att="props" val="rust"/>
    <prop action="exclude" att="props" val="unity"/>
    <!-- Only inlcude NG -->
    <prop action="exclude" att="props" val="rtc"/>
    <prop action="include" att="props" val="rtc-ng"/>
    <prop action="exclude" att="props" val="hide"/>

[lemon-chen]

现有的 unity 要改为 C#

[HeatherWYL]

Subject Scheme Map 中的如下内容也需要修改，windows->cpp，Windows->All native platforms