W specyfikacjach wymagań systemowych precyzja języka ma kluczowe znaczenie. Każde niedopowiedzenie może prowadzić do błędnych interpretacji, nieporozumień w zespole, a finalnie – do implementacji rozwiązania niezgodnego z rzeczywistymi potrzebami biznesowymi.
Jednym z elementów wpływających na precyzję w komunikacji technicznej są zdania względne. Choć dla wielu osób wydają się one tylko gramatycznym detalem, w kontekście dokumentacji technicznej – ich rola jest nie do przecenienia.
Kiedy używać zdań względnych?
Zdania względne (ang. relative clauses) służą do dodawania informacji o rzeczowniku bez konieczności rozpoczynania nowego zdania. Są to struktury, które pozwalają rozszerzać, doprecyzowywać i wyjaśniać, co autor ma na myśli – bez rozwadniania głównej treści zdania. W języku technicznym, gdzie istotna jest zarówno zwięzłość, jak i jednoznaczność, są niezastąpione.
Przykład:
- The user who is logged in can access the dashboard. – Użytkownik, który jest zalogowany, może uzyskać dostęp do panelu.
Zastosowanie tych zdań w dokumentacji technicznej jest korzystne z kilku powodów:
- ułatwiają zrozumienie zdania głównego,
- pomagają wyeliminować powtórzenia,
- pozwalają pominąć zbędne informacje,
- uspójniają język dokumentacji,
- zmniejszają ryzyko błędnej interpretacji.
W dokumentacji systemowej pojawiają się one praktycznie wszędzie tam, gdzie opisujemy komponenty, funkcje, użytkowników lub interakcje. Właściwe ich stosowanie może decydować o tym, czy zespół programistów dobrze zrozumie wymagania.
Dlaczego warto opanować relative clauses?
Nie chodzi tylko o poprawność językową. W międzynarodowych zespołach, gdzie wspólnym językiem pracy jest najczęściej angielski, umiejętność tworzenia klarownych, gramatycznie poprawnych zdań warunkuje skuteczność komunikacji. Dobrze skonstruowane zdania względne pozwalają:
- uniknąć wieloznaczności,
- tworzyć bardziej naturalne i płynne wypowiedzi,
- zachować spójność terminologiczną,
- eliminować zbędne powtórzenia.
Czym są w języku angielskim relative clauses?
Zdania względne, znane też jako zdania przydawkowe, to zdania podrzędne opisujące lub identyfikujące osobę, rzecz, miejsce lub czas. W języku angielskim zdania przydawkowe rozpoczynają się od zaimka względnego (relative pronoun):
- who (osoby) – the woman who helped me,
- which (rzeczy, zwierzęta) – the book which she gave me,
- that (osoby i rzeczy) – the car that he bought,
- whose (przynależność) – the man whose car was stolen,
- where (miejsce) – the restaurant where we met,
- when (czas) – the year when she was born,
- why (powód) – the reason why he left,
- whom (dopełnienie dla ludzi w języku formalnym) – the teacher whom I met.
Przykłady:
She is the person who helped me.
To jest osoba, która mi pomogła.
He is the man that fixed my computer.
To jest mężczyzna, który naprawił mój komputer.
This is the book which explains it clearly.
To jest książka, która to jasno wyjaśnia.
That is the house where I grew up.
To jest dom, w którym się wychowałem.
I remember the year when we met.
Pamiętam rok, w którym się poznaliśmy.
She is the singer whose songs are famous.
To jest piosenkarka, której piosenki są znane.
The man whom you met is my boss.
Mężczyzna, którego poznałeś, to mój szef.
The cake that Mike baked was delicious.
Ciasto, które upiekł Mike, było pyszne.
The girl who lives next door is very friendly.
Dziewczyna, która mieszka obok, jest bardzo miła.
The dog which barked all night kept me awake.
Pies, który szczekał całą noc, nie dał mi spać.
The picture that hangs on the wall is mine.
Obraz, który wisi na ścianie, jest mój.
The student who answered the question was right.
Uczeń, który odpowiedział na pytanie, miał rację.
The reason why she left remains unclear.
Powód, dla którego odeszła, pozostaje niejasny.
Podsumowanie zaimków względnych:
| Zaimek względny | Odnosi się do | Przykład (angielski) | Tłumaczenie (polski) |
|---|---|---|---|
| who | osoby | The user who logs in | Użytkownik, który się loguje |
| which | rzeczy, zwierzęta | The module which handles input | Moduł, który obsługuje dane wejściowe |
| that | osoby i rzeczy | Any system that fails must retry | Każdy system, który zawiedzie, musi ponowić próbę |
| where | miejsca | The folder where logs are stored | Folder, w którym zapisywane są logi |
| when | czas | The moment when the app crashes | Moment, w którym aplikacja się zawiesza |
| why | powody | The reason why the service restarted | Powód, dla którego usługa została zrestartowana |
| whom | osoby (jako dopełnienie) | The developer whom you emailed | Programista, do którego napisałeś |
| whose | przynależność | The user whose session expired | Użytkownik, którego sesja wygasła |
Jakie są rodzaje relative clauses i kiedy ich używać?
Wyróżniamy dwa główne rodzaje:
- Defining relative clauses (zdania względne określające – defining clauses)
- Dostarczają informacji niezbędnej do zidentyfikowania osoby lub rzeczy.
- Brak przecinków.
- Przykład: The book that you gave me is interesting.
- Non-defining relative clauses (zdania względne nieokreślające – non defining clauses)
- Dodają dodatkowe informacje, które można pominąć bez zmiany sensu zdania głównego.
- Zawsze oddzielone przecinkami.
- Przykład: My sister, who lives in Canada, is visiting us next week.
⚠️ Uwaga: W defining clauses nigdy nie stosujemy przecinków – ich użycie może całkowicie zmienić sens zdania.
Przykład: The user who logs in… (dobrze) vs. The user, who logs in… (źle – sugeruje, że każdy użytkownik loguje się).
Zauważmy, że w defining relative clause użycie that jest częstsze i preferowane w mowie potocznej. Which może brzmieć bardziej formalnie. W non-defining relative clauses słowo that nie jest poprawne.
Kiedy zaimek względny jest podmiotem, a kiedy dopełnieniem?
W zdaniach zaimek względny może pełnić funkcję podmiotu (np. the boy who helped me) lub dopełnienia (np. the book which I bought). Pominięcie zaimka względnego jest możliwe tylko wtedy, gdy nie jest on podmiotem zdania względnego.
Przykłady:
- The student you met yesterday (pominięcie who/whom – dopełnienie)
- The girl who won the prize (who jest podmiotem, nie można pominąć)
Jak tworzyć relative clauses w dokumentacji technicznej?
Przy tworzeniu specyfikacji technicznych najlepiej trzymać się kilku zasad:
- Używaj defining relative clauses , gdy chcesz jednoznacznie wskazać, o który element chodzi.
- Unikaj nadmiernego użycia who is , which is , jeśli nie wnoszą one istotnej treści – lepiej być zwięzłym.
- Stosuj that zamiast which w defining clauses, ponieważ brzmi bardziej naturalnie w języku technicznym.
- Zwracaj uwagę, czy przecinki są potrzebne – błędna interpunkcja może zmienić sens wypowiedzi.
Dobrym pomysłem jest też ograniczenie liczby zdań wielokrotnie złożonych – jedno relative clause na zdanie wystarczy. Przykład poprawny:
- Any user who is not authenticated must be redirected to the login page.
(Każdy użytkownik, który nie jest uwierzytelniony, musi zostać przekierowany na stronę logowania.)
Dlaczego zdania względne są kluczowe w specyfikacjach wymagań systemowych?
W specyfikacjach systemowych często pojawiają się sformułowania opisujące role użytkowników, komponenty systemu, ograniczenia, wyjątki i zależności. Wszystko to można (i warto) opisać z użyciem zdań względnych – dla precyzji, klarowności i spójności.
Przykłady użycia defining relative clauses
- A service that retries failed HTTP requests must implement exponential backoff.
(Usługa, która ponawia nieudane żądania HTTP, musi implementować mechanizm eksponencjalnego opóźnienia.) - Users who do not accept the terms will not be granted access.
(Użytkownicy, którzy nie zaakceptują warunków, nie uzyskają dostępu.) - Endpoints that expose personal data must be secured with OAuth2.
(Punkty końcowe, które udostępniają dane osobowe, muszą być zabezpieczone za pomocą OAuth2.)
Relative clauses that – kiedy używać?
Fraza ta odnosi się do zdań względnych, które zawierają zaimek that. W dokumentacji technicznej ich użycie jest bardzo częste, ponieważ są bardziej zwięzłe niż which i dobrze komponują się ze stylem inżynierskim. Przykład:
- Components that fail during initialization must raise an alert.
Warto pamiętać, że that można stosować zarówno do ludzi, jak i do rzeczy – choć w praktyce, w kontekście systemów IT, najczęściej dotyczy to obiektów systemowych.
Checklista: Poprawne użycie relative clauses w dokumentacji technicznej
Sprawdź każdy punkt, zanim zatwierdzisz zapis w wymaganiach:
- Czy zdanie względne rzeczywiście doprecyzowuje kluczowy element?
- Czy zastosowano defining relative clause , jeśli informacja jest niezbędna?
- Czy unikasz zbędnych zaimków typu which is , who is bez wartości dodanej?
- Czy stosujesz that zamiast which , tam gdzie to możliwe (w stylu technicznym)?
- Czy interpunkcja (przecinki) jest zgodna z typem zdania względnego?
- Czy zdanie nie zawiera zbyt wielu relative clauses naraz?
- Czy zdanie jest jednoznaczne i nie budzi wątpliwości interpretacyjnych?
- Czy nie można go uprościć, zachowując tę samą informację?
Najczęściej zadawane pytania (FAQ)
1. Czy w dokumentacji IT powinienem używać „that” czy „which”?
W dokumentacji technicznej zaleca się stosowanie „that” w defining relative clauses, ponieważ brzmi bardziej naturalnie i technicznie. „Which” jest poprawne, ale częściej używane w tekstach ogólnych.
2. Czy mogę pominąć zaimek względny?
Tak – ale tylko wtedy, gdy nie pełni on funkcji podmiotu. Np. The tool (that) we used was outdated.
3. Czy native speakerzy zawsze trzymają się zasad?
Nie. W mowie potocznej często stosują uproszczenia, np. pomijają „that” lub „who” tam, gdzie kontekst jest jasny. W dokumentacji lepiej jednak trzymać się reguł.
4. Czy zdania względne są przydatne w e-mailach technicznych?
Jak najbardziej – pomagają pisać zwięźle i jednoznacznie, co jest kluczowe np. w zgłoszeniach błędów lub przy analizie wymagań.
Sprawdź się – relative clauses w języku angielskim
Przetłumacz poniższe zdania na angielski, stosując poprawne relative clauses i zaimki względne:
- Użytkownicy, którzy nie potwierdzą rejestracji, nie będą mieli dostępu do systemu.
- Moduł, który obsługuje płatności, musi być przetestowany pod kątem błędów brzegowych.
- Pliki, które nie zostały zsynchronizowane, powinny być oznaczone jako „pending”.
Podsumowanie
Znajomość zdań względnych (relative clauses) to nie tylko kwestia gramatyki – to kompetencja komunikacyjna, która realnie wpływa na jakość tworzonych specyfikacji systemowych. Poprawne stosowanie defining relative clauses , dobór zaimków (who , that , which) oraz dbałość o strukturę zdań pozwalają wyeliminować niejasności i zwiększyć efektywność pracy w zespole IT.
Opanowanie takich konstrukcji czy rozumienie roli fraz typu who is to elementy, które powinien znać każdy specjalista odpowiedzialny za tworzenie lub interpretowanie dokumentacji technicznej. Precyzyjny język to podstawa dobrze działającego systemu – również tego komunikacyjnego.
