bchavez / bchavez/Bogus

Random history facts generation

Open
#525 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
C#
Stars
9.7k
Forks
538
PR merge metrics
No merged PRs in 30d

Description

### Description

**Purpose**: The feature aims to enhance Bogus by including a random historical facts generator.

**Expected Behavior**: The user should be able to generate random historical facts without specifying years.
The generated data should include a mix of historical events from different time periods.

**Potential Use Cases**: Generating historical data for testing and development purposes. Adding realism to applications that require historical context.

### LINQPad Code Example

```
var faker = new Faker();
string randomHistoricalFact = faker.Events.History();
```

### What alternatives have you considered?

1. **External APIs**: Considered using external APIs that provide historical facts.
_Issues_:
Dependency on external services, potential reliability issues.
Privacy and security concerns.
2. **Manual Customization**: Users manually curating and inputting their historical facts.
_Issues_:
Tedious and time-consuming for users.
Limited diversity in generated data.

### Could you help with a pull-request?

Yes

Contributor guide

Open the contributing guide

Research direction

Start by locating the Events entry point represented by faker.Events.History() and review how generated data is organized. Define the historical-fact data source and the supported time-period mix before implementation. Done means users can call faker.Events.History() without specifying years and receive varied historical facts without external API dependencies.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
content
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.