It may be better to place some description files in other directories, such as/dat/description and/dat/database. This way, the files will be more organized, some hard coded information may be easier to maintain, and the information in the /description and /database directories will be easier to translate, making it easier to promote the game to players in other languages with the official version.
Description of artifact effects in art-data.txt. Artifact not only have their own description, but also have description for its effects. The former is located in the unrand.txt file in the/dat/description directory, while the latter is located in the art-data.txt file in the /source directory. If the latter is also placed in the/dat/description directory, it may be more uniform. The text files in the source directory are all Cpp language program files, while art-data.txt is an exception.
Description of the effect of the item in describe.cc. Scarves, orbs, and randarts not only have their own description, but also have description for their effects. The former is located in the items.txt file in the/dat/description directory, while the latter is located in the art describe.cc file in the /source directory. If the hard coded descriptions in descripte.cc could also be transferred to the/dat/description directory, it would be easier to maintain. By the way, there are many types of scrolls, potions, rings, and amulets, but each type has its own descriptive text, some of which are also very interesting. But scarves and orbs, although there are various types, have the same descriptive text. If they also have different descriptions, the game may be more immersive.
Quickstart.md, crawl.6, macro_guide.txt, options_guide.txt, changelog.txt, and apt-tmpl.txt, apt-tmpl wide.txt in the/docs/template directory are displayed in the Instructions menu. However, the FAQ information, which is also in this menu, is stored in/dat/database/FAQ.txt. I hope these files can be saved in the same directory as FAQ.txt to facilitate display in other languages, or the docs directory can be set to be translated into other languages like the /description and /database directories.
I really like this game and am also translating it, hoping to let more friends have access to this game. Thanks a lot to developers!