Utilisez Google Docs
J'ai déjà conçu des règles de GN à l'aide de Google Docs, et c'était génial. Les règles de GN, même si elles sont généralement plus courtes que celles des RPG sur table (une centaine de pages contre plusieurs centaines de pages), doivent être beaucoup plus précises, car il n'y aura pas de présence constante du MJ pour juger de chacune des applications des règles. Elles doivent également passer par de nombreuses itérations, ce qui peut également être source de confusion.
J'ai également une grande expérience de l'utilisation de Google Docs à différentes fins, que ce soit avec quelqu'un ou seul. Je l'utilise comme mon principal programme de bureau, et je n'ai même pas de programmes de bureau hors ligne normaux installés sur mon PC.
Pourquoi devriez-vous utiliser Google Documents, ou, pour être plus exact, Google Drive ?
- Google Drive est essentiellement très similaire à un dossier normal sur votre ordinateur. Vous pouvez diviser vos règles en parties qui se trouvent toutes dans un seul dossier, ce qui réduit considérablement la confusion. Par exemple, nous avons placé les règles de combat dans un document distinct des règles d'économie, afin qu'il soit plus facile de comprendre ce qui est modifié.
- Il est entièrement gratuit. Il vous suffit d'enregistrer un compte GMail. À moins que vous n'ayez besoin de stocker des fichiers particulièrement volumineux, les 15 Go gratuits que vous obtenez devraient être plus que suffisants. La conception d'un GN a un budget très limité, car elle est réalisée par des bénévoles, et le budget est formé par les joueurs couvrir les coûts de l'organisation de l'événement, la gratuité est donc un atout majeur. Un RPG open-source n'a probablement pas de budget.
- Son utilisation ne nécessite que très peu de formation. Si vous êtes formé à l'utilisation d'un logiciel de bureautique standard comme Microsoft Office ou Open/Libre Office, vous apprendrez à utiliser Google Documents en un temps record. En fait, tout ce que vous aurez à savoir, ce sont les paramètres de partage et le contrôle de l'historique des versions, dont l'utilisation ne demande que très peu d'efforts particuliers. Si vous n'êtes pas intéressé par l'apprentissage d'un grand nombre de nouvelles choses complexes, Google Docs offre de nombreuses fonctionnalités qui sont vraiment faciles à apprendre.
- Il prend en charge de nombreux types de fichiers : pas seulement du texte brut, mais aussi des dessins, des feuilles de calcul de type Excel, etc. Nous avons utilisé une feuille de calcul Google pour les calculs budgétaires, un dessin Google pour le marquage du territoire de jeu, des formulaires Google pour accepter les données des joueurs, et une feuille de calcul pour les stocker. Vous n'aurez probablement pas besoin de calculer le budget d'un RPG "open-source", mais vous pourriez utiliser des feuilles de calcul pour d'autres calculs importants, pour lesquels vous auriez typiquement besoin d'Excel.
- Vous pouvez télécharger facilement tout fichier que vous pouvez visualiser dans l'un des formats courants, tels que .odt, .docx ou .pdf. Vous pouvez également en faire une copie distincte ajoutée à votre Google Drive.
- Le téléchargement de Google Drive ne nécessite absolument aucun logiciel spécial. Si vous disposez de l'un des navigateurs les plus courants, vous pouvez utiliser Google Drive. Si vous avez un smartphone Android, vous pouvez aussi avoir un Google Drive entièrement fonctionnel ! Cela signifie également que la configuration requise pour utiliser Google Drive est très faible, et que vous pouvez l'utiliser sur n'importe quel PC, même si vous n'êtes pas autorisé à y installer des logiciels.
- Google Drive permet à plusieurs personnes de modifier le même fichier en même temps. Elles verront quelles parties sont en cours d'édition par les autres. Cela peut se passer très bien si vous avez tous une bonne connexion Internet, ou moins bien - dans ce dernier cas, vous devrez vous abstenir de modifier les mêmes lignes dans le même document, mais la plupart des systèmes que je connais ne le permettent pas du tout ! Et, encore une fois, vous pouvez le faire si votre internet est bon, surtout si vous utilisez une sorte de communication vocale lors de l'édition, comme Discord, TeamSpeak, Skype, ou simplement en vous asseyant ensemble lors d'une réunion hors ligne :)
- Vous n'avez pas besoin d'une connexion Internet permanente pour modifier les fichiers de votre Google Drive. La quasi-totalité des fonctionnalités de Google Drive sont disponibles hors connexion. Je n'ai pas l'expérience du travail hors ligne pendant de longues périodes (plus de quelques heures pour des documents partagés, plus de quelques jours pour des documents édités uniquement), mais vous pouvez, par exemple, éditer un fichier pendant quelques heures lorsque vous êtes dans le train, et les changements seront automatiquement téléchargés la prochaine fois que vous aurez une connexion Internet.
- Vous pouvez également avoir des fichiers autres que Google Docs dans votre Google Drive. Mais Google Docs ne prend pas d'espace dans votre Drive, alors que les fichiers 3d prennent de l'espace.
- Il dispose d'une fonction intégrée de sauvegarde automatique qui se produit toutes les quelques secondes. Vous ne perdrez pas votre travail si l'électricité s'éteint soudainement, ou si votre système d'exploitation se plante.
- Vous ne pouvez pas non plus perdre vos fichiers en raison d'une défaillance du disque dur. Vous pouvez en fait faire confiance à Google pour le stockage de vos fichiers.
- Il possède des paramètres parfaits de partage et de contrôle de version que j'aborde dans les deux prochains chapitres :)
Comment fonctionnent les paramètres de partage de Google Drive ?
El Propriétaire du document a tous les droits sur ce document, et ils ne peuvent être révoqués que par le propriétaire lui-même : le propriétaire devra transférer le document à un autre propriétaire.
Le propriétaire, entre autres, peut faire les choses suivantes avec n'importe quel document Google ou dossier Google Drive :
- Ajoutez des personnes spécifiques avec des adresses GMail spécifiques à la liste de partage, en attribuant des privilèges spécifiques à chacune d'entre elles. Le propriétaire peut également supprimer des personnes de la liste.
- Créez un lien vers le document qui peut être partagé, en attribuant un niveau de privilège à l'utilisateur. tout personne qui reçoit le lien.
Les niveaux de privilèges sont, par ordre croissant, les suivants :
- "Peut voir". Vos fichiers ne sont visibles par personne par défaut, vos données sont donc privées, mais vous pouvez autoriser des personnes spécifiques à les consulter, ou les partager par le lien avec un nombre illimité de participants. Les personnes autorisées à consulter le document verront également le processus d'édition en cours, le cas échéant. Ils ne seront pas autorisés à voir l'historique des versions, à partager le fichier avec quelqu'un d'autre et à modifier les paramètres de partage. Dans les GN, nous utilisons ces paramètres pour les joueurs qui sont autorisés (et tenus !) à lire les règles, mais certainement pas à les modifier.
- "Peut commenter". Très utile pour vos bêta-lecteurs. Ceux qui ont ce privilège sont autorisés à sélectionner une partie du document et à saisir leur commentaire pour celle-ci. C'est très utile pour discuter de parties spécifiques de votre texte. Les commentaires ne sont visibles que par les autres commentateurs et par ceux qui peuvent effectivement modifier le document. Les commentateurs sont également autorisés à suggérer des modifications : elles apparaissent dans un formatage spécifique afin qu'il soit facile de distinguer une suggestion d'un texte fini. Les suggestions ne sont pas visibles par les "spectateurs", mais uniquement par ceux qui peuvent modifier le texte et le commenter. Même si vous êtes autorisé à modifier vous-même le document, il peut être utile d'utiliser la mécanique des suggestions et des commentaires pour que les spectateurs ne voient vos modifications que lorsqu'elles sont prêtes, mais puissent toujours accéder à votre document par le même lien. Nous n'avons pas eu de personnes qui n'étaient autorisées qu'à commenter, mais ces fonctionnalités étaient couramment utilisées.
- "Peut éditer". Ces personnes peuvent faire à peu près tout : modifier le texte directement, changer les paramètres de partage, accepter et rejeter les modifications suggérées, supprimer les commentaires et les marquer comme résolus, etc. Ils peuvent voir et utiliser pleinement l'historique des modifications. Ceci devrait être utilisé pour l'équipe de vos principaux collaborateurs. Mais gardez à l'esprit, encore une fois, que les "éditeurs" ont également la possibilité de suggérer des modifications, et qu'il est souvent préférable de retravailler une partie du texte via une modification suggérée et de ne l'"accepter" vous-même que lorsque la modification est prête à être présentée.
Notez que les mêmes niveaux de privilèges existent pour votre équipe avec des adresses e-mail données (évidemment, les privilèges de chaque membre sont séparés) et pour le partage de liens. Si vous ne donnez pas votre lien à beaucoup de personnes, vous pouvez activer le commentaire de lien, mais ce sera un désordre si beaucoup de personnes ont ce droit alors que vous travaillez activement sur le document.
Si vous travaillez sur quelque chose avec votre seul ami proche et uniquement avec lui, vous pouvez lui donner un lien avec des privilèges d'édition. Mais s'il y a une fuite, toute personne qui le trouve pourra modifier le document.
Pour gérer les paramètres de partage, faites un clic droit sur le fichier et appuyez sur "Partager".
Ici est le manuel officiel de partage.
Comment fonctionne l'historique des versions de Google Drive ?
Il y a un très bon manuel officiel sur le contrôle de version mais, par souci d'exhaustivité, je vais en partager les bases ici.
Pour accéder à l'historique des versions, cliquez sur le bouton situé à droite du bouton "Aide". Il peut être lu de l'une des manières suivantes :
-
"Toutes les modifications sont enregistrées dans Drive" -- si vous venez de l'éditer, et que les modifications sont enregistrées avec succès.
-
"La dernière modification a été faite [période de la dernière modification]". -- s'il a été édité par vous il y a quelque temps.
-
"La dernière modification a été faite [période de la dernière modification] par [auteur de la dernière modification]". -- s'il a été édité il y a quelque temps, et pas par vous.
Vous pouvez éditer lorsque vous êtes hors ligne, et il y aura un signal textuel si les modifications sont enregistrées hors ligne ou si quelque chose se passe mal, mais vous ne pouvez pas accéder à l'historique des versions hors ligne.
Lorsque vous cliquez sur ce bouton, vous verrez une liste de versions (révisions), classées par ordre chronologique (la plus récente en premier, la plus ancienne en dernier). Pour chaque version, vous verrez l'heure et la date, ainsi que les auteurs.
Si vous cliquez sur une révision, vous pourrez voir chaque modification dans le texte, y compris l'auteur de chaque modification, et vous pourrez revenir à la révision en question.
Si vous cliquez sur les trois points alignés verticalement à droite du nom de chaque révision, vous pourrez nommer une révision, en signalant brièvement les modifications. Un bouton dans le coin supérieur droit vous permet de ne regarder que les révisions nommées ou de les regarder toutes en même temps.
Vous pouvez signaler les modifications nommées dans le texte, comme "Version 3.1a : blablabla modifié". La meilleure façon de s'assurer que la version que vous lisez sur papier est très claire est d'ajouter des en-têtes de page : ils seront ajoutés automatiquement pour chaque page si vous appuyez sur "Insérer", puis "En-tête", et ensuite entrez le nom/numéro de la version.
Pendant que vous travaillez sur un document, vous pouvez entrer les modifications comme "suggérées", et nommer une révision chaque fois que vous acceptez quelque chose, en le signalant dans le texte. Il est également bon d'avoir un journal des modifications écrit. Nous n'en avons pas eu besoin parce que nous n'avions pas besoin de forker nos règles, mais d'autres Russes qui conçoivent des GNL avec Google Docs l'ont fait (par exemple, celui qui a créé un modèle de médecine très populaire, peut-être le plus populaire en Russie).
Lancement de nouvelles versions
D'après mon expérience, c'est une très mauvaise idée d'autoriser l'accès à la version en direct à toute personne qui n'est pas censée la modifier. Une fois que vous avez apporté un nombre important de modifications, vous pouvez décider que vous êtes prêt à faire une nouvelle version alpha. Que devez-vous faire alors ?
- Mettez à jour le journal des modifications, qui devrait se trouver dans le fichier débutant de votre document. Lorsque vous lisez une version légèrement différente d'un document familier, il est très facile de ne pas voir les modifications importantes. Vous pouvez passer en revue toutes vos modifications dans le Google Doc depuis la dernière version, et écrire simplement ce qui a changé depuis. Il est en fait préférable d'écrire le journal des modifications. tandis que travailler sur une nouvelle version, mais si certains de vos participants ne font pas tout correctement, vous devrez peut-être procéder à une nouvelle vérification, ou même décider de faire tout le travail de versionnement vous-même, ce qui n'est pas une mauvaise idée. Nous n'avons pas eu de véritables changelogs pendant notre développement, mais nous avions des documents de "résolution", où nous avons écrit ce que nous avions décidé de changer à chacune de nos réunions.
- Mettez à jour le numéro de version. Il doit figurer quelque part sur la page de titre, afin que vous puissiez le voir clairement, mais n'oubliez pas de l'ajouter également sur un en-tête de page, de sorte que si vous avez une version imprimée et que les pages sont séparées, vous ne soyez pas perdu dans le chaos. Changez également le nom du document, afin de ne pas vous y perdre. C'est une bonne idée de baser votre nom de version sur la date et l'heure de la version et sur le nom de la fourche, ainsi il pourrait se lire comme suit : " Version 30.11.2017 2:22 alpha Main_fork ", où " Main_fork " est le nom de votre fork. Mieux vaut inventer quelque chose de plus ou moins original, de sorte qu'il soit facile de Ctrl+F pour cela. N'utilisez pas de mots communs comme noms de fork.
- Faites une copie de votre document dans votre propre Drive, et gèlez toute modification du document publié. Révoquez les droits d'édition de tous ceux qui y ont accès, afin qu'ils ne puissent pas modifier l'ancienne version, et ne la modifiez pas vous-même. Nommez l'ancien document exactement de la même manière que sa version, et publiez-le de la manière que vous utilisez : partage de liens, exportation au format PDF, etc.
- Copiez les données du journal des modifications de l'ancienne version dans le journal des modifications principal à la fin du document, afin de disposer d'une liste complète de vos modifications.
De cette façon, tout lecteur comprendra très clairement quelle version il lit, quelles modifications ont été apportées et, grâce aux bons outils de gestion des versions, il sera très facile de marquer les modifications.
Comment peut-on avoir une bifurcation ?
Comme nous l'avons mentionné, Google Docs dispose d'un outil intégré permettant de faire une copie de tout document que vous pouvez consulter, y compris vos propres documents. Pour ce faire, il suffit de cliquer sur "Fichier", puis sur "Faire une copie". Le problème est que la copie ne diffère en rien du fichier original, à l'exception de son nom : elle s'appellera "Copie de [nom du fichier précédent]". Elle sera également no héritent de l'historique des versions du fichier original. Cela signifie que vous devrez de toute façon marquer les modifications manuellement.
Si quelqu'un veut bifurquer votre projet, vous pouvez donner les actions suivantes, que vous pouvez exiger dans votre licence :
- Faire une copie du document via la fonctionnalité "Faire une copie".
- Nommez votre nouvelle fourche en remplaçant l'ancien nom par le vôtre. Par exemple, si l'ancien nom était "Main_fork", vous pouvez le remplacer par "Brave_new_fork" dans les en-têtes de page, sur la page de titre et dans le nom du document.
- Déplacez le changelog de la fourche que vous avez copiée à la fin du document.
- Commencez votre nouveau changelog avec une ligne qui dit quelque chose comme "Forked from version X of fork Y, named Z, on day DD.MM.YYYY".
Comment obtenir la liste des modifications d'un document ?
Imaginons que quelqu'un ait bifurqué de votre RPG, qu'il ait fait une liste de changements populaires, mais qu'il ait omis de les documenter correctement. Pour les trouver, vous devrez faire une copie de la version sur laquelle elle est basée, et du document forqué lui-même. Vous devez sélectionner toutes les données du document bifurqué et les copier (Ctrl+A, Ctrl+C), puis sélectionner tout et le coller sur la copie du document de l'ancienne version (Ctrl+A, Ctrl+V). Vous pouvez ensuite examiner les modifications apportées en vérifiant l'historique des révisions. Vous pourrez documenter vous-même toutes les modifications et, peut-être, les incorporer dans votre fourche principale.
Dans l'ensemble, Google Docs fonctionne parfaitement pour les petits projets développés par de petites équipes (en dessous de 10 personnes par exemple), mais je ne peux rien dire à propos de quelque chose de plus important. Notez que, bien que je l'aie fait pour moi-même, j'ai zéro l'expérience de la bifurcation de documents en tant qu'effort communautaire.
3 votes
Je vote pour fermer cette question comme hors-sujet car elle concerne les systèmes de gestion de versions de documents, et non pas les jeux de rôle. Le fait que le système de version de documents sera utilisé pour les jeux de rôle ne rend pas la question à propos de jeux de rôle.
12 votes
@ObliviousSage En fin de compte, je pense que cette question juste passe. Il n'y a pas beaucoup d'entreprises dans lesquelles le texte en anglais nécessite une version soignée ; vous avez soit un contrôle de la source pour la programmation, soit une version plus décontractée/informelle pour les documents (brouillons, etc.). Je ne suis pas sûr s'il y a un meilleur endroit pour poser cette question, et cette question suscite de l'intérêt ici.
5 votes
Je voterai pour rouvrir ceci tel quel une fois que cela sera fermé; c'est une question pertinente dans un domaine du site que je souhaite voir se développer.
3 votes
Je pense que la réponse de @Baskakov_Dmitriy montre clairement pourquoi cette question peut être considérée comme pertinente pour ce site.
0 votes
Que attendez-vous exactement de la fonctionnalité de forking?
0 votes
@Baskakov_Dmitriy de la fonctionnalité de forking, je m'attends au minimum à un système de numérotation/nommage des versions qui prend en compte quand elles ont été forkées, et combien de versions ont été créées depuis. Au maximum, je suppose que je m'attends à une manière de suivre les changements qui sont back-ported. (Ce qui, je soupçonne, pourrait être pour déterminer si le back-porting peut être considéré comme l'équivalent de
git rebase
et, si c'est le cas, compter les versions à partir de là.)0 votes
@LyndonWhite Je suis désolé, mais vous n'avez pas beaucoup de choix dans ce cas, vos exigences sont controversées. Vous avez dit que tout système professionnel comme GitHub, dont la fonction principale est le forking, est très hostile envers vos collègues et les forkers potentiels, assez hostile pour le refuser, et le forking est également très nécessaire pour vous, vous ne trouverez rien qui corresponde à vos critères. Dans mon expérience, écrire un changelog en texte brut basé sur la liste des modifications générées par Google Docs n'est pas difficile, mais si ces personnes échouent à le faire, vous êtes condamné. Le versioning/foraging nécessite de toute façon des efforts.
1 votes
Salut Lyndon, je mets ceci en attente temporairement afin que nous puissions régler quelque chose. Il y a un manque de clarté autour de cette question qui suscite des inquiétudes et des drapeaux, notamment en réaction à votre dernière modification : le problème auquel vous semblez être confronté concerne la gestion des versions, mais vous avez modifié cette question pour la limiter à la demande d'un système de numérotation des versions. Ce sont des concepts totalement différents (par exemple, le contrôle de version de logiciel que vous mentionnez peut ne pas du tout impliquer de numérotation spécifique des versions) et je crains que vous les confondiez en vous attendant à ce que le second résolve le premier.
0 votes
Il y a plusieurs réponses ici préconisant une gestion pratique des versions et l'une des réponses les mieux cotées actuellement souligne comment la simple numérotation des versions ne résoudra pas les problèmes de gestion des versions que vous décrivez. Je suggère que vous révisiez cela pour vous concentrer sur nous demander de résoudre votre problème principal et de ne pas vous concentrer sur la numérotation des versions comme La Solution. (Réviser cela pour démontrer pourquoi une numérotation de version pourrait tout régler, et se concentrer davantage là-dessus, pourrait ne pas fonctionner car il pourrait être fermé comme étant basé sur des opinions (le choix du schéma de version est arbitraire) et hors sujet (nous ne traitons pas les recommandations de ce type).)
0 votes
@doppelgreener le titre a toujours dit marquage de version. Je pense que ma dernière édition était mineure. J'ai été surpris que les réponses incluent une gestion complète des versions. Ce que je cherchais, c'était un système pour marquer de manière cohérente les copies PDF/Impression. SemVer n'est pas arbitraire, c'est un système structuré pour nommer les versions de votre API. Des arguments solides peuvent être avancés pour expliquer pourquoi il est meilleur que les alternatives pour les numéros de version d'API (des arguments peuvent également être avancés pour d'autres systèmes). Demander comment numéroter les versions des logiciels serait une bonne opinion sur SoftwareEngineering SE (je pense).
0 votes
La réponse de @Ace rpg.stackexchange.com/a/110661/1362 est le genre de choses que je cherchais vraiment. J'ai l'impression que cela met en lumière le cycle de conception / publication / playtesting du JDR de manière utile. Je suppose que je devrais réfléchir à la manière de modifier la question pour obtenir plus de réponses comme celle-ci.
0 votes
@LyndonWhite Cela fonctionnerait - mais notez que c'est aussi la réponse à laquelle je faisais référence, qui décrit la gestion des versions, et ne mentionne que brièvement un système de numérotation de version réelle. (Et je ne veux pas dire que la numérotation des versions elle-même est arbitraire - j'ai utilisé semver, je sais que le choix de quand et comment mettre à jour le numéro de version n'est pas arbitraire - je veux dire que le choix du système de numérotation des versions est généralement arbitraire. Il n'y a pas de meilleur système de numérotation de version unique ou correct, il y a simplement ce qui fonctionne bien pour votre équipe.)
0 votes
Je suggérais que le choix du schéma n'est pas arbitraire, il y a des avantages et des inconvénients qui peuvent être analysés au-delà de simplement ce qui fonctionne pour votre équipe (comme je suis sûr que vous le savez déjà). Aucun meilleur choix ne fait quelque chose d'opinionné. Aucune façon factuelle/logique d'argumenter l'un ou l'autre ne le rend opinionné. Je ne suis pas sûr de comment éditer ceci maintenant (il est assez tard ici). Si vous voulez proposer une modification qui rendrait cette question utile (et peut-être ne casserait pas trop les réponses existantes). Je serais heureux de le prendre.
1 votes
@LyndonWhite Au départ, je pensais que je voterai pour rouvrir votre question une fois qu'elle serait fermée, mais maintenant j'en suis moins sûr. Pouvez-vous s'il vous plaît nous rejoindre dans le salon de discussion principal de RPG.SE afin que nous puissions résoudre certains problèmes autour de votre question ? Il semble actuellement très difficile de comprendre ce que vous essayez exactement d'atteindre, et quel montant d'effort vous êtes prêt à investir et attendez de vos assistants qu'ils soient prêts à investir.