2011-11-08 13 views
20

Tworzymy specyfikację w korniszonie i chcielibyśmy przedstawić pliki funkcji dla interesariuszy biznesowych. W jaki sposób możemy wyeksportować wszystkie nasze pliki funkcji w jakimś "ładnym" formacie?Dość wydajne pliki cech korniszonów

Na przykład:

  • wygenerować dokument zawierający wszystkie funkcje
  • lub zintegrować funkcje do innej dokumentacji
  • lub publikować pliki funkcji na portalu internetowym (ładnie sformatowany)
+0

Czy możesz wyjaśnić, który z nich wybrałeś na końcu i jak możesz go obsługiwać w firmie? – vikramvi

+0

Opuściłem projekt i firmę przed podjęciem decyzji. – dgmstuart

+0

czy próbowałeś tego w nowym projekcie i firmie? Twoje dane wejściowe będą bardzo pomocne dla społeczności i dla mnie :) – vikramvi

Odpowiedz

11

Najlepsze, jakie widziałem do tej pory, to pikle; http://github.com/picklesdoc/pickles

Jest to praca w toku, ale już wygląda dobrze. Prześlij swoją opinię na temat GitHub

+0

Opuściłem projekt już teraz, ale ten wyglądał najbardziej obiecująco - właściwie zaczęliśmy go używać, ale nie wiem, jak daleko za nim doszło. – dgmstuart

+2

@dgmstuart żyje i kopie! Dodano obsługę JSON i DITA, a także wsparcie dla uruchamiania z wiersza poleceń, powershell (na przykład w VS2010), MsBuild i NAANT. Sprawdź to: http://nuget.org/packages/Pickles –

+1

Wygląda na to, że projekt został przeniesiony na https://github.com/picklesdoc/pickles –

2

Jak myślisz, dlaczego chcesz to zrobić?

Sugerowałbym, że piękno bdd polega na tym, że zapewnia wszechobecny język pomiędzy interesariuszami, testerami i programistami. Można go wykorzystać w dowolnej części cyklu testowania, aby opisać funkcje, które chcesz i scenariusze, których przestrzegają. Z plikiem funkcji stylu korniszonu jako zwykłym plikiem tekstowym, można go edytować bezpośrednio przez interesariusza biznesowego i przenieść bezpośrednio z powrotem do repozytorium kodu źródłowego. Możesz dosłownie zabrać ze sobą nowe scenariusze i potwierdzić, które funkcje działają, zanim napiszesz jeden wiersz kodu.

Udostępniając inny format tych plików, przeszkadza się w łatwości przesyłania danych przez te mosty. Tak, możesz go upiększyć i zgrupować wszystkie funkcje razem, w dokumencie tekstowym itp., Ale w ten sposób tracisz możliwość bezpośredniego zrobienia zestawu scenariuszy prosto z firmy i wykazania, że ​​baza kodu "działa" dla nich.

Więc sugerowałbym, że najlepszym formatem przedstawianie interesariuszy biznesowych jest dokładnie taki sam jak format one już są.

jednak masz uważane zmieniając biegacza swoich testów. Nawet jeśli funkcje są nadal w postaci zwykłego tekstu, biegacz taki jak concordion lub Concordion.net da bardzo ładny obraz przebiegu testowego.

+5

Cześć. Tak, zgadzam się, wolałabym nie zadzierać z Format, ale głównym problemem, który należy rozwiązać, jest przedstawienie specyfikacji użytkownikom - w ogóle nie są oni zaawansowani technicznie, więc nie będę w stanie zmusić ich do pobrania aktualizacji do lokalnego repozytorium! liczba naprawdę podstawowych wyzwań: dzielenie się z kontrolą kodu źródłowego, prezentowanie specyfikacji w sposób czytelny wizualnie (np. z podświetlaniem składni) i prezentowanie tylko listy opisów funkcji dla interesariuszy wyższego szczebla Wszelkie pomysły z tego punktu widzenia – dgmstuart

+0

rozważałeś wdrożenie interfejsu? Ktoś (główny projektant/kierownik zespołu/doświadczony kierownik projektu) kontaktuje się z użytkownikami. Zatwierdzają poprzez e-mail do interfejsu, który następnie obsługuje rzeczywiste zatwierdzenie. Tak, to nie jest idealne, ale utrzymuje wszystko w ruchu, a kto wie, gdy się przyzwyczają do tego pomysłu, będą również popełniać to samo. – AlSki

+6

Odziedziczyłem system z 450 historiami o łącznej liczbie 46 000 słów - i rośnie. Próba zrozumienia funkcjonalności z plików tekstowych artykułów tekstowych jest jak próba zrozumienia architektury systemu poprzez odczytanie tysięcy linii kodu. Jeśli historie mają służyć jako dokumentacja, musi istnieć mechanizm do łatwego powiększania lub pomniejszania do poziomu, na którym chcesz wyświetlać. –

3

Nasz zespół korzysta obecnie z relish, projektu kodu, który ładnie formatuje korniszony na stronie internetowej.

Ma jednak pewne wady - jest tylko "za darmo w fazie beta", ale to może dać ci kilka pomysłów.

Przyjemną cechą smaku jest to, że zespół programistów może wybrać pchania korniszonów, gdy tylko będą gotowe, a interesariusze nie będą musieli zarządzać/otrzymywać nowych e-maili/dokumentów itp. - mogą po prostu odświeżyć projekt Strona internetowa.

+1

Cześć - dziękuję, tak, widziałem już Relish, ale niestety firma nie miała nic przeciwko otwieraniu specyfikacji dla wszystkich - to ogromny minus. Spojrzeliśmy na pikle, które nie jest zbyt dojrzałe, ale wyglądało interesująco. Opuściłem firmę, do której ten problem był istotny ... – dgmstuart

+0

AFAIK "wszystko, co trzeba zobaczyć" nie jest dokładne. Musisz przesłać pliki funkcji do witryny smakowej - w związku z tym zaangażowana jest strona trzecia, ale Twoje strony z zaprzyjaźnionymi stronami są widoczne tylko dla twojego własnego loginu. – perfectionist

+0

Wygląda na to, że dodali prywatne projekty od czasu, gdy ostatnio je oglądałem. – dgmstuart

0

Mieć go z Gherkin Viewer

Stworzyłam ten chrom przedłużeniu do tego celu, jak mi się nie podoba się pomysł eksportowania/publikowanie plików fabularnych. To pozwala na oglądanie oryginalnego źródła prawdy :)

https://chrome.google.com/webstore/detail/gherkin-viewer/lfckgakamnfdbanfefglincnckfnlapp?hl=en-GB

przyjrzeć, sprawdzić, czy to działa dla Ciebie.Źródło znajduje się na GitHub, bardzo podstawowym początku, jeśli ktoś chciałby wnieść swój wkład, jest bardzo ceniony.

1

Inna opcja, która nie wymaga żadnych umiejętności technicznych. Podobny do innej odpowiedzi tutaj, ale jest specjalnie zaprojektowany, aby odwoływać się do biznesu, a nie zainteresowanych stron technicznych. To rozszerzenie Chrome, które automatycznie formatuje dowolny plik * .ature otwarty w przeglądarce Chrome. Zobacz przykłady i zainstaluj tutaj: Pretty Gherkin feature file viewer