விரைவுத் தொடக்கம்
Dropstone-ஐ நிறுவி, உள்நுழைந்து, ஐந்து நிமிடங்களுக்குள் உங்கள் முதல் மாற்றத்தை அனுப்புங்கள். இந்த வழிகாட்டி உங்களை பூஜ்ஜியத்திலிருந்து வேலை செய்யும் ஏஜென்ட் லூப்பிற்கு அழைத்துச் செல்கிறது.
இந்த வழிகாட்டியின் முடிவில் Dropstone நிறுவப்பட்டு, உள்நுழைந்து, உங்கள் விருப்பத் திட்டத்தில் உண்மையான திருத்தங்களை உருவாக்கும் நிலையில் இருப்பீர்கள்.
தொடங்குவதற்கு முன்
உங்களுக்கு தேவை:
- ஒரு டெர்மினல் அல்லது கட்டளை வரியூட்டி
- Dropstone-ஐ சுட்டிக்காட்ட உங்கள் கணினியில் ஒரு திட்டம் (எந்த மொழியிலும், எந்த அளவிலும்)
- ஒரு Dropstone கணக்கு, அதை dropstone.io இல் உருவாக்கலாம்
படி 1: Dropstone-ஐ நிறுவவும்
உங்கள் தளத்திற்கான நிறுவல் வழியைத் தேர்ந்தெடுக்கவும்.
Homebrew (பரிந்துரைக்கப்படுகிறது):
brew tap blankline-org/dropstone-cli
brew install dropstone
அல்லது நிறுவல் ஸ்கிரிப்ட்:
curl -fsSL https://dropstone.io/install | bash
இரண்டு முறைகளும் உங்கள் PATH இல் ஒரு dropstone பைனரியை நிறுவுகின்றன. Node இல்லை, ரன்டைம் சார்புகள் இல்லை.
நிறுவலைச் சரிபார்க்கவும்:
dropstone --version
நீங்கள் ஒரு பதிப்பு எண்ணைக் காண வேண்டும் (தற்போதைய வெளியீடு 1.0.8). பைனரி தொடங்கும்போது புதுப்பிப்புகளைச் சரிபார்த்து அவற்றை நிறுவுகிறது, எனவே நிறுவியை மீண்டும் இயக்காமல் நீங்கள் தற்போதைய நிலையில் இருக்கிறீர்கள். Homebrew உடன் நிறுவியிருந்தால், brew upgrade dropstone பயன்படுத்தவும் — Homebrew அந்த பைனரியை வைத்திருக்கிறது, Dropstone அதைத் தொடாது.
படி 2: உள்நுழைக
எந்த திட்ட கோப்புறைக்கும் சென்று Dropstone-ஐத் தொடங்கவும்:
cd /path/to/your/project
dropstone
முதல் தொடக்கத்தில் உள்நுழையும்படி கேட்கப்படுவீர்கள். இரண்டு விருப்பங்கள்:
- உலாவியில் தொடரவும் (பரிந்துரைக்கப்படுகிறது). dropstone.io/login ஐத் திறந்து, உங்களை உள்நுழையச் செய்து, டோக்கனை தானாகவே CLI-க்கு திருப்பித் தருகிறது. PKCE ஐப் பயன்படுத்துகிறது, எனவே டோக்கன் உங்கள் உலாவி URL பட்டியில் தோன்றாது.
- டோக்கனை ஒட்டவும். SSH அல்லது ஹெட்லெஸ் அமர்வுகளுக்கு. dropstone.io/account இல் டோக்கனைப் பெற்று அதை ஒட்டவும்.
முதல் உள்நுழைவுக்குப் பிறகு உங்கள் சான்றுகள் வட்டில் சேமிக்கப்படும். பின்னர் கணக்குகளை மாற்ற, Dropstone-க்குள் /login இயக்கவும்.
படி 3: உங்கள் முதல் அமர்வைத் தொடங்கவும்
நீங்கள் இப்போது Dropstone முகப்புத் திரையைப் பார்க்கிறீர்கள். மூன்று விஷயங்களைக் கவனிக்கவும்:
- உங்கள் தற்போதைய மாடல் அடுக்கு மேல் வலதுபுறத்தில் காட்டப்படுகிறது (இயல்புநிலை: Dropstone Fast)
- கீழே உள்ள உள்ளீட்டு பெட்டி நீங்கள் தட்டச்சு செய்யும் இடம்
- ஸ்லாஷ் கட்டளைகள்
/உடன் தொடங்குகின்றன. அனைத்தையும் காண/helpமுயற்சிக்கவும்
அமர்வைத் தொடங்க எந்த இயற்கை மொழி வரியையும் தட்டச்சு செய்யவும். கற்றுக்கொள்ள சிறப்பு தொடரியல் இல்லை.
படி 4: உங்கள் முதல் கேள்வியைக் கேளுங்கள்
திட்டத்தை உங்களுக்காக சுற்றிப்பார்க்க Dropstone-ஐ அனுமதிக்கவும். இவற்றில் ஒன்றை முயற்சிக்கவும்:
இந்த திட்டம் என்ன செய்கிறது?
முக்கிய நுழைவு புள்ளிகள் யாவை?
கோப்புறை அமைப்பை விளக்குங்கள்
Dropstone தேவைக்கேற்ப கோப்புகளைப் படித்து உண்மையான குறியீட்டிற்கான மேற்கோள்களுடன் பதிலளிக்கும். நீங்கள் கோப்புகளை ஒட்டவோ அல்லது சூழலை கைமுறையாக எழுதவோ தேவையில்லை.
Dropstone-ஐப் பற்றியும் நீங்கள் கேட்கலாம்:
இந்த திட்டத்தில் நீங்கள் என்ன செய்ய முடியும்?
எந்த கட்டளைகளை இயக்க உங்களுக்கு அனுமதி வழங்கப்பட்டுள்ளது?
படி 5: உங்கள் முதல் குறியீடு மாற்றத்தைச் செய்யுங்கள்
இப்போது ஒரு சிறிய மாற்றத்தை விவரிக்கவும். புதிய திட்டத்திற்கு, குறைந்த ஆபத்துள்ள ஒன்றை முயற்சிக்கவும்:
ஒரு பத்தி திட்ட விளக்கத்துடன் README சேர்க்கவும்
ஏற்கனவே உள்ள திட்டத்திற்கு:
பயனரை உருவாக்கும் செயல்பாட்டிற்கு உள்ளீடு சரிபார்ப்பைச் சேர்க்கவும்
Dropstone:
- தொடர்புடைய கோப்பைக் கண்டுபிடிக்கும்
- முன்மொழியப்பட்ட மாற்றத்தை diff ஆகக் காண்பிக்கும்
- எழுதுவதற்கு முன் உங்கள் ஒப்புதலைக் கேட்கும்
- முடிவைச் சரிபார்க்கும் (வகை சோதனைகள், சோதனைகள், lints கிடைத்தால்)
அனுமதிகள்
Dropstone ஒரு கோப்பைத் திருத்த அல்லது ஷெல் கட்டளையை இயக்க முதல் முறை ஒப்புதல் கேட்கிறது. ஒருமுறை ஒப்புதல் அளித்தால், அதே அமர்வில் அதே செயல்பாடு மீண்டும் கேட்காமல் இயங்கும். நீங்கள் அனுமதித்ததைப் பார்க்க அல்லது ரத்து செய்ய /permissions பயன்படுத்தவும்.
படி 6: git உடன் வேலை செய்யுங்கள்
Dropstone git-ஐ முதல் தர கருவியாகக் கருதுகிறது:
நான் எந்த கோப்புகளை மாற்றினேன்?
விளக்கமான செய்தியுடன் என் மாற்றங்களை commit செய்யுங்கள்
feature/health-endpoint என்ற கிளையை உருவாக்கி அதற்கு மாறவும்
கடைசி ஐந்து commits காட்டுங்கள்
src/auth.ts இல் உள்ள merge conflict ஐ தீர்க்க உதவுங்கள்
PR-நிலை பணிப்பாய்வுகளுக்கு (pull requests திறப்பது, PR விளக்கங்களை உருவாக்குவது, மதிப்பாய்வு கருத்துகளை இடுவது), GitHub ஒருங்கிணைப்பு பார்க்கவும்.
படி 7: ஒரு பிழையை சரிசெய்யவும் அல்லது அம்சத்தைச் சேர்க்கவும்
நீங்கள் விரும்புவதை எளிய மொழியில் விவரிக்கவும். Dropstone குறியீட்டைக் கண்டுபிடித்து, சூழலைப் புரிந்துகொண்டு, மாற்றத்தைச் செயல்படுத்தி, சரிபார்க்கும்.
காலி தேடல் வினவல்கள் அனைத்து முடிவுகளையும் திருப்பித் தரும் ஒரு பிழை உள்ளது - அதை சரிசெய்யுங்கள்
API சேவையகத்திற்கு build தகவலைத் திருப்பித் தரும் /healthz endpoint சேர்க்கவும்
மின்னஞ்சல் இல்லாதபோது உள்நுழைவு படிவம் செயலிழக்கிறது - ஏன் என்று கண்டுபிடித்து சரிசெய்யுங்கள்
பணி பல கோப்புகளை உள்ளடக்கியிருந்தால், Dropstone ஒரு சிறிய திட்டத்தை எழுதி படிப்படியாக செயல்படுத்தும். எந்த நேரத்திலும் Esc அழுத்தி குறுக்கிட்டு வழிநடத்தலாம்.
படி 8: மற்ற பொதுவான பணிப்பாய்வுகளை முயற்சிக்கவும்
Dropstone சிறப்பாக செய்யும் சில முறைகள்:
மறுசீரமைப்பு
auth தொகுதியை callbacks க்கு பதிலாக async/await பயன்படுத்த மறுசீரமைக்கவும்
சோதனைகளை எழுதுங்கள்
கால்குலேட்டர் செயல்பாடுகளுக்கு யூனிட் சோதனைகளை எழுதுங்கள்
குறியீடு மதிப்பாய்வு
என் staged மாற்றங்களை மதிப்பாய்வு செய்து ஆபத்தானவற்றை சுட்டிக்காட்டுங்கள்
ஆவணப்படுத்தல்
README நிறுவல் வழிமுறைகளை WSL பாதையை சேர்க்க புதுப்பிக்கவும்
Tip
Dropstone-ஐ ஒரு சக ஊழியரைப் போல பேசுங்கள். நீங்கள் அடைய விரும்புவதை விவரிக்கவும், அங்கு செல்ல சரியான படிகளை அல்ல. செயல்படுத்தல் தேர்வுகளை அதற்கு விட்டுவிடும்போது ஏஜென்ட் திட்டமிடலில் சிறந்தது.
அத்தியாவசிய கட்டளைகள்
நீங்கள் உண்மையில் பயன்படுத்தும் சில கட்டளைகள்:
| கட்டளை | இது என்ன செய்கிறது | எடுத்துக்காட்டு |
|---|---|---|
dropstone | தற்போதைய கோப்பகத்தில் ஒரு ஊடாடும் அமர்வைத் தொடங்கவும் | dropstone |
dropstone run "task" | ஒரு முறை பணியை இயக்கி வெளியேறவும் | dropstone run "explain auth.ts" |
dropstone -c | இந்த கோப்பகத்தில் கடைசி அமர்வைத் தொடரவும் | dropstone -c |
dropstone --session ID | குறிப்பிட்ட அமர்வை ஐடி மூலம் மீட்டெடுக்கவும் | dropstone --session 7f3a... |
/help | அனைத்து ஸ்லாஷ் கட்டளைகளையும் காட்டவும் | அமர்வுக்குள் |
/effort | இந்த அமர்விற்கான மாடல் அடுக்கை மாற்றவும் | /effort high |
/clear | தற்போதைய உரையாடலை அழிக்கவும் | அமர்வுக்குள் |
/login | கணக்குகளை மாற்றவும் | அமர்வுக்குள் |
exit அல்லது Ctrl+D | Dropstone-இலிருந்து வெளியேறவும் |
முழு குறிப்பு CLI மற்றும் ஸ்லாஷ் கட்டளைகள் பக்கங்களில் உள்ளது.
புதிய பயனர்களுக்கான தொழில்முறை உதவிக்குறிப்புகள்
அடுத்தது என்ன
உதவி பெறுதல்
- Dropstone-க்குள்,
/helpதட்டச்சு செய்யவும் அல்லது எளிய மொழியில் கேளுங்கள் ("மாடல்களை எவ்வாறு மாற்றுவது?") - மற்ற ஆவணங்களை docs.dropstone.io இல் உலாவவும்
- dropstone.io/contact இல் ஒரு சிக்கல் அல்லது அம்ச கோரிக்கையை தாக்கல் செய்யவும்